kaizen-term

---

[!WARNING] KaizenTerm is in open alpha. APIs, storage formats, and UI details may change between releases.

What Is KaizenTerm?

KaizenTerm is a multi-agent terminal cockpit for developers who run more than one coding agent at a time.

Instead of juggling terminal windows, branches, task notes, and API keys manually, KaizenTerm gives you a single operator view:

• launch multiple terminal agents in parallel,
• isolate work in dedicated Git worktrees,
• track work through a built-in Kanban board,
• inspect terminal output and handoffs,
• manage terminal environment secrets without exposing values.

The goal is simple: multiple agents, one operator, less chaos.

Why It Exists

Single-agent workflows are sequential. Real product work is not.

You may need one agent fixing auth, another writing tests, another cleaning UI, and another preparing release notes. Without orchestration, you lose track of branches, terminals, task state, and credentials.

KaizenTerm turns that into an execution loop:

Task -> Worktree -> Agent terminal -> Watch output -> Review -> Ship

Core Capabilities

Capability	What It Does
Multi-agent terminals	Run Claude Code, Codex CLI, Aider, OpenCode, or any shell-based agent side by side.
Tauri desktop shell	Native Rust backend with PTY lifecycle, task storage, secret storage, and app packaging.
xterm.js UI	Fast terminal rendering with WebGL fallback, search, copy, export, watch mode, and bounded output queues.
Worktree swarm	Create isolated Git worktrees and spawn agents with shared mission context.
Kanban board	Create tasks, assign agents, move work through backlog, doing, review, and done.
Mission Control	Inspect agents, tasks, status, last output, and active handoffs from one overlay.
Secret rotation view	Inventory terminal env keys, owners, rotation dates, and due state without returning secret values.
Terminal env files	Load global and project-local dotenv files into every spawned terminal.
Local AI helper	Uses Ollama with gemma4:e2b as the small default model.

Product Identity

The public product name is KaizenTerm.

Brand source files live in docs/brand.md:

• public/brand/kaizenterm-mark.svg
• public/brand/kaizenterm-app-icon.svg
• public/brand/kaizenterm-wordmark.svg
• public/brand/kaizenterm-lockup.svg
• public/brand/kaizenterm-og-card.svg

Native app icons are generated into src-tauri/icons/ and embedded through src-tauri/tauri.conf.json.

Video Kit

This repo includes Remotion compositions for product marketing videos.

Composition	Format	Use
KaizenTermLaunch	1080x1920, 15s	Reels, Shorts, TikTok launch teaser.
KaizenTermOverview	1920x1080, 12s	Landing page hero, demo intro, YouTube.
KaizenTermPoster	1600x900 still	Thumbnail, social preview, release cover.

Commands:

# Open Remotion Studio
npm run video:studio

# List available compositions
npm run video:compositions

# Render a poster frame
npm run video:still
npm run video:poster

# Render vertical launch video
npm run video:render:launch

# Render horizontal overview video
npm run video:render:overview

Rendered files go to output/, which is intentionally ignored by Git.

The GitHub Pages landing page lives in docs/index.html. Its deployable media assets live under docs/assets/.

Quick Start

Requirements

• Node.js >=20.19 or >=22.12
• Rust stable toolchain
• macOS, Linux, or Windows
• One or more shell-based coding agents, such as claude, codex, aider, or opencode
• Optional: Ollama for local AI helper flows; default model is gemma4:e2b

Install And Run

git clone https://github.com/juancruzmunozalbelo/kaizen-term.git
cd kaizen-term
npm install
npm run dev

Build

npm run build

The macOS bundle is produced under:

src-tauri/target/release/bundle/macos/KaizenTerm.app

The DMG is produced under:

src-tauri/target/release/bundle/dmg/

Legacy Electron commands remain available while the Tauri migration settles:

npm run dev:electron
npm run build:electron

Terminal Environment

KaizenTerm loads environment variables into every new terminal from:

1. ~/.kaizen-term/terminal.env for global terminal env.
2. .kaizen-term.env in the terminal working directory for project-local overrides.

Format is dotenv-style. No shell expansion or command execution is performed.

# @secret OPENAI_API_KEY rotate=90d last=2026-04-01 owner=platform note="OpenAI prod"
OPENAI_API_KEY="sk-..."

# @secret ANTHROPIC_API_KEY next=2026-07-01 owner=platform
ANTHROPIC_API_KEY="..."

MY_FLAG=true

Secret metadata supports:

• rotate=90d or rotate_days=90
• last=YYYY-MM-DD
• next=YYYY-MM-DD
• owner=name
• note="free text"

The inventory view returns key names, file paths, line numbers, owners, and rotation state. It does not return secret values.

Project-local .kaizen-term.env is ignored by this repo. Keep secrets out of committed files.

Project Structure

kaizen-term/
├── src-tauri/          Rust and Tauri desktop shell
├── src/                TypeScript app, modules, styles, Tauri bridge
├── public/brand/       Brand SVG assets
├── video/              Remotion compositions
├── docs/               Documentation and brand guide
├── electron/           Legacy Electron shell
├── mcp-server/         Local MCP server
└── package.json

Verification

Useful local checks:

npx tsc --noEmit
npm run build:web
npm run build:tauri
npm run video:compositions

Ecosystem

Project	Description
KaizenTerm	Multi-agent terminal cockpit.
SwarmClaw	Autonomous multi-agent swarm control plane.
SwarmDash	Real-time AI agent dashboard.

License

MIT License. See LICENSE.

Author

Juan Cruz Muñoz Albelo

• GitHub: @juancruzmunozalbelo
• LinkedIn: juan-cruz-albelo-