CodeKanban

agent
Guvenlik Denetimi
Basarisiz
Health Gecti
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 185 GitHub stars
Code Basarisiz
  • rm -rf — Recursive force deletion command in .github/workflows/build.yml
  • child_process — Shell command execution capability in build-npm-multipackage.py
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This tool is a unified web dashboard for managing multiple terminal sessions and monitoring the status of AI coding agents like Claude Code and Codex. It provides a visual Kanban board to track project tasks, agent progress, and conversation histories in one place.

Security Assessment
The tool manages local terminals and monitors AI processes, which inherently requires access to your local system shell and file paths. The automated scan flagged two areas of concern: a recursive force deletion command (`rm -rf`) inside a GitHub Actions workflow, and shell command execution capabilities within a Python build script. Neither of these presents a direct threat to your daily runtime environment, as they are strictly used for automating the project's packaging and deployment. No dangerous permissions or hardcoded secrets were detected in the application itself.

Because the application is designed to interface directly with your terminal and local development environment, it naturally handles sensitive data such as system file paths, shell histories, and active AI prompts. However, it operates entirely as a local tool with a local database, minimizing external network privacy risks. Overall runtime risk is rated as Low.

Quality Assessment
The project is actively maintained, with its most recent code push occurring today. It utilizes standard development languages (Go, Vue, TypeScript) and is protected under the permissive Apache-2.0 open-source license. Community trust is moderate and growing, indicated by 185 GitHub stars, which reflects a healthy level of adoption and peer interest for a niche developer utility.

Verdict
Safe to use. The required shell executions are safely isolated within build and CI pipelines, making this a well-maintained, highly useful tool for local AI-assisted development workflows.
SUMMARY

Manage all your terminals and ai coding agents from one unified page.

README.md

Code Kanban

中文 | English

Manage all your terminals and AI coding tools (Claude Code / Codex) from one unified page.

Core FeaturesQuick StartDevelopment GuideAbout

Go
Vue
TypeScript
License

Preview

Quick Start

Try it instantly:

npx codekanban
# or
npm install -g codekanban@latest
codekanban

Core Features

  • 🚀 Ready to Use
    Single-file deployment, local database, double-click to run.

  • 📊 Multi-Project & Multi-Terminal Management
    Manage all your projects and terminals from one unified page (Hotkey: `).

  • 🔍 AI Coding Tool Status Detection
    Auto-detect running status of Claude Code / Codex and other tools (idle/working/needs approval), notify when tasks complete.

  • 📜 History
    Record your conversations with AI, one-click to trace prompt history, automatically add as tasks.

  • 📋 Task Kanban
    Visualize development task management, clear and intuitive.

  • 🌿 Worktree Management
    Basic support for worktree branch creation and management, enabling parallel development.

  • 📝 Notes
    Multi-tab notes for quick recording of ideas and issues (Hotkey: 1).

Development Guide

Requirements

  • Node.js: v20.19.0+ or v22.12.0+
  • Go: 1.24.6+
  • Package Manager: pnpm (recommended)

Install Dependencies

Frontend Dependencies:

cd ui
pnpm install

Backend Dependencies:

go mod tidy

Development Mode

Frontend Development Server:

cd ui
pnpm dev

Access at: http://localhost:5173

Backend Development Server:

go run . # Note: After first run, config.yaml will be generated with port 3007. Due to conflicts with the production version, they cannot run simultaneously. It's recommended to change to 3005. The following assumes it has been changed.
  • Server Port: http://localhost:3005
  • OpenAPI Documentation: http://localhost:3005/docs
  • Health Check: http://localhost:3005/api/v1/health

Optional Parameters:

  • -m or --migrate: Force database migration
  • -i or --install: Install as system service
  • --uninstall: Uninstall system service

Production Build

Full Build (Recommended):

python build.py

This script will automatically complete the following steps:

  1. Build frontend (pnpm build)
  2. Copy frontend artifacts to static/ directory
  3. Build Go executable (with optimization)

Manual Build:

# Build frontend
cd ui && pnpm build

# Build backend
go build -ldflags="-s -w" -trimpath -o CodeKanban

Build Artifacts:

  • Frontend: ui/dist/static/ (After moving to this directory, building the backend will automatically store it in the executable, achieving single-file launch)
  • Backend: CodeKanban.exe (Windows) or CodeKanban (Linux/macOS)

Access Application

Development Environment:

  • Frontend Dev Server: http://localhost:5173
  • Backend API: http://localhost:3005

Production Environment:
Run the built executable and access http://localhost:3007

About

We are in an era that is both rapidly changing and extremely divided, and our work is the same.

This tool has genuinely improved my efficiency, but perhaps the improvement in efficiency will also reduce work demand, and the development of AI will eliminate this industry.

Anyway, I hope everyone enjoys using it.

If it helps you, you can give it a star or sponsor me a little.

Possible Future Features

  • Mobile support
  • Code cleanup: For example, the frontend's src/api should all be auto-generated
  • Completion reminder feature, such as playing a sound after AI is done to tell you it's finished.
  • Idle terminal list / Terminal list awaiting interaction.

Yorumlar (0)

Sonuc bulunamadi