Skip to content

Cygnusfear/ramboard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

47 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Ramboard

Multi-project ticket board for tk. Reads .tickets/ directories from local repos. Kanban and list views. Vim bindings. Full markdown. Read-write.

Board view List view

Why

AI coding agents generate tickets. pi-stuff routes all agent coordination through tk โ€” task delegation, progress tracking, inter-agent handoff. Tickets accumulate in .tickets/ directories across every project.

Ramboard gives you one board to see them all. Point it at your repos, get a Linear-style UI over plain markdown files. No database, no sync โ€” the filesystem is the source of truth.

Install

bun install

Run

bun run dev

Configure which repos to watch in ramboard.config.ts.

Stack

Layer Choice
Runtime Bun
Server Bun.serve() โ€” no frameworks
Frontend React 19 + Vite + Tailwind v4
State Zustand
DnD @dnd-kit
UI primitives @base-ui-components/react (headless)
Command palette cmdk
Icons @phosphor-icons/react
Fonts Geist + Geist Mono
Animation CSS first, anime.js for spring physics

Features

  • Board view โ€” kanban columns by status, drag cards between columns, drag to reorder columns
  • List view โ€” sortable table with inline status and priority
  • Filters โ€” status, priority, tags, type, assignee, project
  • Search โ€” fuzzy filter across all tickets
  • Vim bindings โ€” j/k navigation, Enter to open, Esc to deselect
  • Command palette โ€” Cmd+K for quick actions
  • Multi-select โ€” bulk status and priority changes
  • Full-page detail โ€” markdown rendering with GFM support
  • Multi-project โ€” one board across all your repos

How it works with pi-stuff

pi-stuff extensions use tk tickets as the coordination layer between agents:

  • teams spawns parallel workers, each claiming tickets from a shared queue
  • todos-tk creates, lists, and completes tickets from inside pi sessions
  • Oracle & Delphi write research findings as tickets

Ramboard renders these same tickets as a visual board. Agents write .tickets/ files; you drag them across columns.

License

MIT

About

๐Ÿ linear/kanban for `tk` tickets

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages