Files

T

José Almeida 041a19f060 feat: service-managed UI self-update (#1210 )

* feat: add service-managed self-update

* chore: add temporary self-update test scripts

* chore: simplify temporary script markdown fences

* chore: run frontend in temporary self-update scripts

* fix: show self-update job progress after apply

* chore: add real npm self-update test script

* fix: isolate npm self-update prefix

* fix: detect npm service installs from bin shim

* chore: reset service before real npm update test

* chore: expand real npm status diagnostics

* fix: preserve service home during self-update

* fix(cli): tee self-update helper output to a log file

* fix(cli): avoid launchd bootstrap race when reloading the macOS service

* fix(backend): run macOS self-update helper once via transient launchd plist

* fix(web): show self-update progress and lock the apply button until the update lands

* fix(cli): reinstall via the kandev wrapper on Homebrew self-update

* chore: remove temp self-update test scripts

* fix(web): drop unused apply path from useUpdates hook

* fix(backend): snapshot install state once in apply preflight

* docs: align self-update docs with transient LaunchAgent flow

* chore(release): run cli bundle from apps workspace root

* fix(backend): guard against concurrent self-update applies

* fix(backend): check scheme and helper paths in self-update apply

* fix(backend): drop duplicate binary name from npx manual command

* fix(cli): allow --help for service self-update without --intent

* fix(cli): harden self-update dir perms and darwin uid resolution

* fix(web): set required POST fields last in applyUpdate

* docs: use JSON body notation for the apply endpoint

* fix(backend): expire self-update guard so a stuck helper cannot wedge apply

* refactor(cli): collapse redundant writeSync branch in self-update log

2026-06-01 17:49:15 +01:00

bin

fix: include agent_profile_id in session WS events to resolve stale MCP status (#354 )

2026-03-03 00:17:23 +00:00

src

feat: service-managed UI self-update (#1210 )

2026-06-01 17:49:15 +01:00

package.json

release: 0.54.0

2026-05-31 21:35:11 +00:00

README_internal.md

feat: brew install + npm sibling channels via OIDC trusted publishing (#806 )

2026-05-05 00:43:34 +01:00

README.md

feat(cli): kandev service install for systemd and launchd (#926 )

2026-05-17 21:12:20 +01:00

tsconfig.json

feat: use github.com for releases instead of api to avoid rate limiting

2026-02-25 02:55:54 +00:00

vitest.config.ts

feat: use github.com for releases instead of api to avoid rate limiting

2026-02-25 02:55:54 +00:00

README.md

Kandev

Manage tasks. Orchestrate agents. Review changes. Ship value.

Quick Start

Homebrew

brew install kdlbs/kandev/kandev
kandev

NPX (requires npm 7+)

npx kandev@latest

Either install path resolves a platform-matched runtime (Go backend, agentctl, Next.js standalone web), launches the backend + web, and opens your browser. Data (worktrees, SQLite DB) is stored in ~/.kandev by default.

Version and Updates

The package manager owns the runtime version. kandev@X.Y.Z ships with the matching runtime.

Update via Homebrew: brew upgrade kandev
Update via npm/npx: npx kandev@latest or npm install -g kandev@latest
Print CLI version: kandev --version

Advanced: pin a specific runtime tag

--runtime-version <tag> downloads a specific GitHub release runtime instead of using the installed one. For debugging compatibility issues only:

kandev --runtime-version v0.16.0

Run as a Service

Install kandev as a systemd (Linux) or launchd (macOS) service so it auto-starts and stays running across reboots:

kandev service install                   # user mode (laptop, single-user)
sudo kandev service install --system     # system mode (VPS, shared host)

See docs/run-as-a-service.md for the full guide — user vs system mode comparison, update workflow, troubleshooting.

What You Get

Multi-agent support - Claude Code, Codex, GitHub Copilot, Gemini CLI, Amp, Auggie, OpenCode
Integrated workspace - Terminal, code editor with LSP, git changes, browser preview, and chat
Kanban & pipeline views - Organize tasks with opinionated workflows and gates
CLI passthrough - Drop into raw agent TUI mode for full terminal access
Workspace isolation - Git worktrees prevent concurrent agents from conflicting
Session management - Resume and review agent conversations

Supported Agents

Agent	Default Model	Protocol
Claude Code	Sonnet 4.5	stream-json
Codex	GPT-5.2 Codex	Codex
GitHub Copilot	GPT-4.1	Copilot SDK
Gemini CLI	Gemini 3 Flash	ACP
Amp	Smart Mode	stream-json
Auggie	Sonnet 4.5	ACP
OpenCode	GPT-5 Nano	REST/SSE

Beta - Under active development. Expect rough edges and breaking changes.

Requirements

Node.js (for npx)
Git
Docker (optional - needed for container runtimes)

Platforms

macOS (Intel + Apple Silicon)
Linux (x64)
Windows (x64, WSL)

Learn More

Open source, multi-provider, no telemetry, not tied to any cloud.

See the GitHub repository for architecture, vision, development setup, and contributing guidelines.

License

AGPL-3.0