Lightweight, ephemeral Kanban boards for humans and AI agents. Create a board instantly — no sign-up required — share the key, and let it expire when the work is done.
- 🚀 Instant Setup: No registration, no login — just create and share
- 🔑 Key-Based Access: Each board gets a unique access key
- ⚡ Real-time Sync: Updates reflect instantly across all clients
- 🎨 Drag & Drop: Intuitive drag-and-drop task management
- 💻 CLI + Web: Use the web UI or command-line interface
- 🤖 AI-Friendly: Perfect for AI agents tracking their own tasks
- 📦 Self-Hostable: Deploy on your own infrastructure
| Component | Language | Description |
|---|---|---|
backend/ |
Go | REST API server |
frontend/ |
React + TypeScript | Web UI |
cli/ |
Go | Command-line interface |
brew tap zeeshanejaz/tap
brew install kanbinscoop bucket add kanbin https://github.com/zeeshanejaz/scoop-bucket
scoop install kanbinwinget install zeeshanejaz.kanbingo install github.com/zeeshanejaz/kanbin/cli/cmd/kanbin@latestDownload the latest binaries for Windows, macOS, and Linux from the GitHub Releases page.
- Go 1.22+
- Node 20+
- PostgreSQL (or Docker)
golangci-lint
# 1. Install all dependencies
task setup
# 2. Configure environment
cp .env.example .env
# Edit .env with your database URL and other settings
# 3. Start the development stack
task devThe frontend dev server starts on http://localhost:5173 and proxies API requests to the backend on http://localhost:8080.
| Command | Description |
|---|---|
task setup |
Install Go and npm dependencies |
task dev |
Start backend + frontend in dev mode |
task build |
Build all components to bin/ |
task test |
Run all tests |
task lint |
Lint all components |
task clean |
Remove build artifacts |
Kanbin includes a command-line interface available as both kanbin and the shorthand kb. If you've installed it via a package manager or go install, it will be in your PATH. If you've built it from source, the binaries are located in the bin/ directory.
By default, the CLI connects to the production server at https://kanbin.app/api. You can override this in two ways:
- Global Flag: Use the
--server(or-s) flag.kb --server http://localhost:8080/api board view <KEY>
- Environment Variable: Set the
KANBIN_URLvariable.export KANBIN_URL=http://localhost:8080/api kb board view <KEY>
# General help
kb --help
# Create a new key-based anonymous board
kb board create "My CLI Board"
# View a board and its tasks
kb board view <BOARD_KEY>
# Add a new task to a board
kb task add "Implement auth" --board <BOARD_KEY>See .specs/ for the project constitution, product specifications, and MVP delivery plan.
We welcome contributions! Please see CONTRIBUTING.md for guidelines on:
- Setting up your development environment
- Code style and standards
- Submitting pull requests
- Reporting issues
This project is licensed under the MIT License - see the LICENSE file for details.