agent-takkub 1.0.2 β†’ 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +79 -54
  2. package/assets/cockpit-main.png +0 -0
  3. package/dist/{agent_takkub-1.0.2-py3-none-any.whl β†’ agent_takkub-1.0.4-py3-none-any.whl} +0 -0
  4. package/package.json +3 -2
package/README.md CHANGED
@@ -1,83 +1,108 @@
1
- <div align="center">
2
-
3
1
  # πŸ›©οΈ agent-takkub
4
2
 
5
- **A desktop cockpit for running a whole team of Claude Code agents β€” together, in one window.**
3
+ **A local-first desktop cockpit for orchestrating a team of Claude Code agents in one unified window.**
4
+
5
+ [![NPM Version](https://img.shields.io/npm/v/agent-takkub?style=flat-square&color=cb3837)](https://www.npmjs.com/package/agent-takkub)
6
+ [![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)](https://github.com/takkub/agent-takkub/blob/main/LICENSE)
7
+ [![Platforms](https://img.shields.io/badge/platform-Windows%20%7C%20macOS-blue?style=flat-square)](https://github.com/takkub/agent-takkub)
8
+ [![Python Version](https://img.shields.io/badge/python-3.11+-blue?style=flat-square&logo=python)](https://www.python.org/)
9
+ [![Node Version](https://img.shields.io/badge/node-%3E%3D18-green?style=flat-square&logo=node.js)](https://nodejs.org/)
6
10
 
7
- You direct a **Lead**; the Lead orchestrates specialist teammates
8
- (frontend Β· backend Β· qa Β· reviewer Β· devops Β· …) as live panes.
11
+ ---
9
12
 
10
- [![npm](https://img.shields.io/npm/v/agent-takkub)](https://www.npmjs.com/package/agent-takkub)
11
- [![license](https://img.shields.io/badge/license-MIT-green)](https://github.com/takkub/agent-takkub/blob/main/LICENSE)
12
- ![platforms](https://img.shields.io/badge/platform-Windows%20%7C%20macOS-blue)
13
+ ## πŸ–₯️ The Desktop Cockpit
13
14
 
14
- `runs entirely on your machine`
15
+ ![Takkub Cockpit β€” Lead + specialist teammates working in parallel](https://cdn.jsdelivr.net/npm/agent-takkub@latest/assets/cockpit-main.png)
15
16
 
16
- </div>
17
+ *One window: you talk to the **Lead**, it spawns and drives specialist teammates (frontend Β· backend Β· qa Β· …) as live Claude Code panes.*
17
18
 
18
19
  ---
19
20
 
20
- ## Install
21
+ ## ✨ Why agent-takkub?
21
22
 
22
- ```bash
23
- npm install -g agent-takkub # isolated Python runtime + a Desktop icon
24
- claude login # one-time auth β€” your Claude account
25
- takkub provision # recommended plugins + browser tooling
26
- ```
27
-
28
- Then **double-click β€œTakkub Cockpit” on your Desktop** β€” or run `agent-takkub`.
23
+ A single AI agent struggles with big features: context fills up, sub-tasks conflict, and everything runs serially. `agent-takkub` uses the **Lead–Specialist pattern**: you prompt one **Lead** agent, and it delegates isolated, specialized sub-tasks to real `claude` processes running concurrently.
29
24
 
30
- > **Prerequisites:** Node β‰₯ 18 and Python β‰₯ 3.11 β€” *detected, never reinstalled.*
31
- > No clone, no manual wiring. Everything lands in an isolated `~/.agent-takkub`;
32
- > your existing `claude` CLI, plugins, and config are left untouched.
25
+ * **🧠 Orchestrated teammates** β€” converse with the Lead; it spawns, tasks, and manages specialist panes (`frontend`, `backend`, `qa`, `reviewer`, `devops`, …) on demand.
26
+ * **πŸ”€ True parallelism** β€” `frontend` and `backend` build features concurrently; QA always verifies last, against the real stack.
27
+ * **🌿 Branch & worktree isolation** β€” parallel teammates each work on their own git branch in an isolated worktree. No commit races, no dirty-state collisions; you merge when ready.
28
+ * **πŸ‘₯ Fleet mode** β€” one toggle scales a role into a fleet (`frontend#1…#K`) sized to your machine, for independent features or sharded test suites.
29
+ * **πŸ–₯️ Steerable processes** β€” every pane is a live `claude` shell. Watch output in real time, interrupt, or type directly into any teammate.
30
+ * **πŸ—‚οΈ Multi-project tabs** β€” one isolated Lead per project; no cross-talk.
31
+ * **πŸ”’ 100% local** β€” no SaaS middleware. Runs on your machine, on your logged-in Claude Code CLI.
33
32
 
34
33
  ---
35
34
 
36
- ## Why
37
-
38
- - **🧠 One Lead, many specialists** β€” talk to the Lead; it spawns the right roles on demand.
39
- - **πŸ”€ Real parallelism** β€” independent features fan out across panes; QA always runs last.
40
- - **🌿 Worktree isolation** β€” parallel agents each work on their own git branch + worktree; you merge when ready, never a commit race.
41
- - **πŸ‘₯ Multi mode** β€” one toggle turns β€œ1 agent per role” into a fleet (`frontend#1…#K`) sized to your machine.
42
- - **πŸ–₯️ Live, steerable panes** β€” every teammate is a real `claude` process you can watch and interrupt.
43
- - **πŸ—‚οΈ Multi-project tabs** β€” one isolated Lead per project, no cross-talk.
44
- - **🧩 Batteries included** β€” Playwright browser automation, curated skill plugins, session memory, decision logs, a self-diagnosing Doctor.
45
- - **πŸ”’ Local-first** β€” no SaaS, nothing leaves your machine; runs on your logged-in `claude`.
35
+ ## ⚑ Quick Start
46
36
 
47
- ---
37
+ ```bash
38
+ # 1. Install the cockpit globally (isolated Python runtime + Desktop icon)
39
+ npm install -g agent-takkub
48
40
 
49
- ## The flow
41
+ # 2. Authenticate with your Claude account (if not already done)
42
+ claude login
50
43
 
44
+ # 3. Provision recommended plugins + browser automation tools
45
+ takkub provision
51
46
  ```
52
- you β†’ Lead β†’ assign β†’ spawn claude pane β†’ work β†’ done β†’ verify (QA) β†’ ship
53
- ↑__________________ fan out across roles __________________↑
47
+
48
+ Then double-click **Takkub Cockpit** on your Desktop β€” or run:
49
+
50
+ ```bash
51
+ agent-takkub
54
52
  ```
55
53
 
56
- Say what you want. The Lead plans it, dispatches the right specialists, gathers
57
- their results, runs verification, and proposes the ship β€” you stay in control.
54
+ > **Requirements:** Node.js β‰₯ 18 and Python β‰₯ 3.11 on your system β€” *detected, never reinstalled.*
55
+ > Everything else lives in an isolated `~/.agent-takkub`; your existing `claude` CLI, plugins, and config are left untouched.
58
56
 
59
57
  ---
60
58
 
61
- ## Everyday commands
59
+ ## πŸ”„ Orchestration Flow
60
+
61
+ ```mermaid
62
+ sequenceDiagram
63
+ actor User
64
+ participant Lead as Lead Agent
65
+ participant Cockpit as Cockpit Engine
66
+ participant Spec as Specialist Pane(s)
67
+ participant Git as Git Repository
68
+
69
+ User->>Lead: "Build the login feature"
70
+ Lead->>Cockpit: takkub assign --role frontend / backend (parallel)
71
+ Cockpit->>Git: create isolated branch + worktree (optional)
72
+ Cockpit->>Spec: spawn claude pane + inject task
73
+ Note over Spec: teammates code & test independently
74
+ Spec->>Cockpit: takkub done "report"
75
+ Cockpit->>Lead: done notice β†’ verify sequence (devops β†’ QA last)
76
+ Lead->>Git: review + merge branches, propose ship
77
+ ```
78
+
79
+ ---
62
80
 
63
- | Command | |
64
- |---|---|
65
- | `takkub assign --role backend "…"` | spawn + task a teammate |
66
- | `takkub assign --role frontend --isolation worktree "…"` | task on an isolated git branch |
67
- | `takkub assign --role qa --plan --shards 4 "…"` | plan-first parallel browser QA |
68
- | `takkub worktree list / merge / clean` | review + merge isolated branches |
69
- | `takkub send --to qa "…"` | message a peer (Lead CC’d) |
70
- | `takkub restart` | restart the whole cockpit from the terminal |
71
- | `takkub doctor` | diagnose the environment (`--fix` auto-repairs) |
72
- | `takkub provision` | install / repair plugins + browser tools |
81
+ ## πŸ› οΈ Everyday Commands
82
+
83
+ | Command | Purpose |
84
+ | :--- | :--- |
85
+ | `takkub assign --role backend "…"` | Spawn a specialist and assign a task |
86
+ | `takkub assign --role frontend --isolation worktree "…"` | Task on an isolated git branch + worktree |
87
+ | `takkub assign --role qa --plan --shards 4 "…"` | Plan-first parallel browser QA (auto fan-out) |
88
+ | `takkub worktree list / merge / clean` | Review + merge isolated branches |
89
+ | `takkub send --to qa "…"` | Message a teammate (Lead CC’d) |
90
+ | `takkub goal "…"` | Set a session goal injected into every task |
91
+ | `takkub restart` | Restart the whole cockpit from the terminal |
92
+ | `takkub doctor --fix` | Diagnose the environment + auto-repair |
93
+ | `takkub provision` | Install / repair plugins + browser tools |
73
94
 
74
95
  ---
75
96
 
76
- ## More
97
+ ## πŸ“– Deep Dives & Resources
98
+
99
+ - πŸ—οΈ **Architecture & design** β€” [Architecture Guide](https://github.com/takkub/agent-takkub/blob/main/docs/ARCHITECTURE.md)
100
+ - βš™οΈ **System overview & flow diagrams** β€” [docs/system-overview](https://github.com/takkub/agent-takkub/tree/main/docs/system-overview)
101
+ - πŸ”§ **From source / one-shot installer** (Chrome, gh, codex, rtk, …) β€” [INSTALL.md](https://github.com/takkub/agent-takkub/blob/main/docs/INSTALL.md)
102
+ - πŸ™ **GitHub** β€” [takkub/agent-takkub](https://github.com/takkub/agent-takkub)
77
103
 
78
- - **GitHub** β€” [takkub/agent-takkub](https://github.com/takkub/agent-takkub)
79
- - **Architecture & flow diagrams** β€” [docs/system-overview](https://github.com/takkub/agent-takkub/tree/main/docs/system-overview)
80
- - **How it’s built** β€” [docs/ARCHITECTURE.md](https://github.com/takkub/agent-takkub/blob/main/docs/ARCHITECTURE.md)
81
- - **From source / one-shot installer** (Chrome, gh, codex, rtk, …) β€” [docs/INSTALL.md](https://github.com/takkub/agent-takkub/blob/main/docs/INSTALL.md)
104
+ ---
82
105
 
83
- <div align="center"><sub>Windows + macOS Β· built on PyQt6 Β· powered by the Claude Code CLI Β· MIT</sub></div>
106
+ <div align="center">
107
+ <sub>Windows & macOS β€’ built on PyQt6 β€’ powered by the Claude Code CLI β€’ MIT</sub>
108
+ </div>
package/assets/cockpit-main.png ADDED
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agent-takkub",
3
- "version": "1.0.2",
3
+ "version": "1.0.4",
4
4
  "description": "Desktop cockpit for orchestrating a team of Claude Code agents (Windows + macOS)",
5
5
  "keywords": [
6
6
  "claude",
@@ -32,7 +32,8 @@
32
32
  "npm/",
33
33
  "dist/*.whl",
34
34
  "assets/icon.ico",
35
- "assets/icon.png"
35
+ "assets/icon.png",
36
+ "assets/cockpit-main.png"
36
37
  ],
37
38
  "os": [
38
39
  "win32",