Kanbanomo

Kanban-style web application for OpenCode session management.

Kanbanomo provides a visual interface to track and manage tasks across multiple OpenCode projects. It integrates with the oh-my-openagent ecosystem to automatically discover sessions, extract TODOs from plan files, and display them in an intuitive Kanban board.

Features

• Multi-Project Support: Automatically discover all OpenCode projects from the SQLite database
• Kanban Board: 5-column board (Todo, Backlog, In Progress, Review, Done) with drag-and-drop
• Plan Integration: Automatically extract TODOs from .sisyphus/plans/*.md files
• Session Tracking: View active sessions and their metadata
• Task Management: Create, update, and manage tasks with rich markdown support
• Real-Time Updates: Auto-refresh every 5 seconds to sync with backend changes

Prerequisites

• Python 3.11+ - For backend development
• Node.js 18+ - For frontend development
• uv - Python package manager (install from astral.sh)
• npm - Node.js package manager

Installation

1. Clone the Repository

git clone https://github.com/mte90/Kanbanomo.git
cd Kanbanomo

2. Install Backend Dependencies

uv sync

This will create a .venv virtual environment and install all Python dependencies listed in pyproject.toml.

3. Install Frontend Dependencies

cd frontend
npm install
cd ..

4. Configure Environment

Create a .env file in the project root:

PORT=8888
OPENCODE_DB_PATH=/home/mte90/.local/share/opencode/opencode.db

Note: Update OPENCODE_DB_PATH to match your OpenCode database location.

Running the Application

Start Both Backend and Frontend

Use the provided startup script:

./start.sh

This will:

• Start the FastAPI backend on port 8888
• Start the Vue dev server on port 5173

Manual Start

Backend only:

cd backend
uvicorn app.main:app --reload --port 8888

Frontend only:

cd frontend
npm run dev

Dev Mode

For development with hot-reload for both frontend and backend, use the DEV_MODE environment variable:

DEV_MODE=1 ./start.sh

This will:

• Start the Vue dev server on port 5173 with hot-reload
• Start the FastAPI backend on port 8888 with logging enabled
• Allow you to access the app at http://localhost:5173
• Show detailed logs from both servers

Note: In dev mode, access the app at http://localhost:5173 (not 8888), as the frontend dev server proxies API requests to the backend.

API Endpoints

Projects

• GET /api/projects - List all discovered projects
• GET /api/projects/info?project={path} - Get project info with plan progress

Tasks

• GET /api/tasks?project={path} - List all tasks for a project
• POST /api/tasks - Create a new task
• PATCH /api/tasks/{id} - Update a task

Sessions

• GET /api/sessions?project={path} - List active sessions for a project

Health

• GET /health - Health check endpoint

Note: Full API documentation is available at http://localhost:8888/docs (FastAPI auto-generated).

Configuration

Environment Variables

Variable	Description	Default
PORT	Backend server port	8888
OPENCODE_DB_PATH	Path to OpenCode SQLite database	/home/mte90/.local/share/opencode/opencode.db