agent-takkub 1.0.24 β 1.0.26
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.
package/README.md
CHANGED
|
@@ -1,12 +1,23 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
1
3
|
# π©οΈ agent-takkub
|
|
2
4
|
|
|
3
|
-
|
|
5
|
+
### Your AI dev team β in one desktop cockpit.
|
|
6
|
+
|
|
7
|
+
**Prompt one _Lead_ agent. It plans the work, splits it across specialist teammates, runs them in parallel as real `claude` processes, and verifies the result β while you watch and steer.**
|
|
8
|
+
|
|
9
|
+
[](https://www.npmjs.com/package/agent-takkub)
|
|
10
|
+
[](https://www.npmjs.com/package/agent-takkub)
|
|
11
|
+
[](https://github.com/takkub/agent-takkub/blob/main/LICENSE)
|
|
12
|
+
[](https://github.com/takkub/agent-takkub)
|
|
13
|
+
|
|
14
|
+
```bash
|
|
15
|
+
npm install -g agent-takkub
|
|
16
|
+
```
|
|
4
17
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
[](https://www.python.org/)
|
|
9
|
-
[](https://nodejs.org/)
|
|
18
|
+
<sub>100% local Β· runs on **your** logged-in Claude Code CLI Β· no SaaS middleware</sub>
|
|
19
|
+
|
|
20
|
+
</div>
|
|
10
21
|
|
|
11
22
|
---
|
|
12
23
|
|
|
@@ -14,61 +25,79 @@
|
|
|
14
25
|
|
|
15
26
|
|
|
16
27
|
|
|
17
|
-
|
|
28
|
+
<div align="center"><i>One window: you talk to the <b>Lead</b>, and it spawns and drives specialist teammates (frontend Β· backend Β· qa Β· reviewer Β· devops Β· β¦) as live Claude Code panes.</i></div>
|
|
18
29
|
|
|
19
30
|
---
|
|
20
31
|
|
|
21
|
-
##
|
|
22
|
-
|
|
23
|
-
<p align="center">
|
|
24
|
-
<img src="https://raw.githubusercontent.com/takkub/agent-takkub/main/assets/mobile-remote.png" alt="Takkub Remote β drive your Lead from your phone" width="300">
|
|
25
|
-
</p>
|
|
32
|
+
## β¨ Why agent-takkub?
|
|
26
33
|
|
|
27
|
-
|
|
34
|
+
A single AI agent hits a wall on big work: context fills up, sub-tasks collide, and everything runs one-at-a-time. `agent-takkub` runs it like a **real engineering team** β a **Lead** you talk to, and specialist teammates it delegates to, each in its own isolated `claude` process, working **concurrently**.
|
|
28
35
|
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
36
|
+
| | |
|
|
37
|
+
| :-- | :-- |
|
|
38
|
+
| π§ **Orchestrated teammates** | Converse with the Lead; it spawns, tasks, and manages specialist panes (`frontend`, `backend`, `qa`, `reviewer`, `devops`, `mobile`, β¦) on demand β only the roles a job actually needs. |
|
|
39
|
+
| π **True parallelism** | `frontend` and `backend` build a feature at the same time; QA always verifies **last**, against the real running stack. |
|
|
40
|
+
| πΏ **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. |
|
|
41
|
+
| π₯ **Fleet mode** | One toggle scales a role into a fleet (`frontend#1β¦#K`) sized to your machine β for many independent features or sharded test suites at once. |
|
|
42
|
+
| π₯οΈ **Steerable, always** | Every pane is a live `claude` shell. Watch output in real time, interrupt, or type straight into any teammate. |
|
|
43
|
+
| ποΈ **Multi-project tabs** | One isolated Lead per project β no cross-talk. |
|
|
44
|
+
| π **100% local** | No SaaS middleware. Everything runs on your machine, on your logged-in Claude Code CLI. |
|
|
34
45
|
|
|
35
46
|
---
|
|
36
47
|
|
|
37
|
-
##
|
|
48
|
+
## π§ One team, three model "brains"
|
|
38
49
|
|
|
39
|
-
|
|
50
|
+
Model diversity beats a single point of view. Takkub lets the Lead pull in a **second and third brain** for planning, review, and cross-checks β and it never breaks if you don't have them installed.
|
|
40
51
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
52
|
+
| Brain | Backed by | Great at |
|
|
53
|
+
| :-- | :-- | :-- |
|
|
54
|
+
| π£ **Claude** | Claude Code CLI | The Lead + every specialist β build, test, review |
|
|
55
|
+
| π’ **Codex** | OpenAI Codex CLI | Second opinion Β· refactor patterns Β· cross-checking a plan |
|
|
56
|
+
| π΅ **Gemini** | Google Antigravity (`agy`) | Long-context planning (reads the whole repo) Β· a third perspective |
|
|
57
|
+
|
|
58
|
+
> **Never a hard dependency.** If Codex or Gemini isn't installed (or you've toggled it off), the Lead keeps the role β **Claude transparently stands in**, and tells you you've traded away model diversity. No refusals, no dead ends.
|
|
48
59
|
|
|
49
60
|
---
|
|
50
61
|
|
|
51
62
|
## β‘ Quick Start
|
|
52
63
|
|
|
53
64
|
```bash
|
|
54
|
-
# 1. Install the cockpit globally
|
|
65
|
+
# 1. Install the cockpit globally (isolated Python runtime + a Desktop icon)
|
|
55
66
|
npm install -g agent-takkub
|
|
56
67
|
|
|
57
|
-
# 2. Authenticate with your Claude account (if
|
|
68
|
+
# 2. Authenticate with your Claude account (if you haven't already)
|
|
58
69
|
claude login
|
|
59
70
|
|
|
60
|
-
# 3. Provision recommended plugins + browser
|
|
71
|
+
# 3. Provision recommended plugins + browser-automation tools (idempotent)
|
|
61
72
|
takkub provision
|
|
62
73
|
```
|
|
63
74
|
|
|
64
|
-
|
|
75
|
+
> β οΈ **Install it globally β the `-g` flag matters.** It provisions the isolated runtime and the Desktop launcher. A plain `npm install agent-takkub` (no `-g`) will **not** set the app up.
|
|
76
|
+
|
|
77
|
+
Then **double-click βTakkub Cockpitβ** on your Desktop β or launch from a terminal:
|
|
65
78
|
|
|
66
79
|
```bash
|
|
67
80
|
agent-takkub
|
|
68
81
|
```
|
|
69
82
|
|
|
70
|
-
>
|
|
71
|
-
>
|
|
83
|
+
<table>
|
|
84
|
+
<tr><td>
|
|
85
|
+
|
|
86
|
+
**Requirements** β Node.js β₯ 18 and Python β₯ 3.11 already on your system. They're **detected, never reinstalled**. Everything else lives in an isolated `~/.agent-takkub`; your existing `claude` CLI, plugins, and config are left completely untouched.
|
|
87
|
+
|
|
88
|
+
</td></tr>
|
|
89
|
+
</table>
|
|
90
|
+
|
|
91
|
+
---
|
|
92
|
+
|
|
93
|
+
## π¦ Two ways to run: 1:1 or a whole team
|
|
94
|
+
|
|
95
|
+
A chip in the status bar flips how the Lead works:
|
|
96
|
+
|
|
97
|
+
- **π€ 1:1 (default)** β one agent per role, one feature at a time. Focused and predictable.
|
|
98
|
+
- **π₯ Multi** β hand the Lead several independent features and it **fans out** into multiple instances per role (`frontend#1β¦#K`, `backend#1β¦#K`) running at once, like a team of several devs per position. Finishes fast.
|
|
99
|
+
|
|
100
|
+
Dependent work stays sequential automatically; **QA is always the final gate**, run against the real stack.
|
|
72
101
|
|
|
73
102
|
---
|
|
74
103
|
|
|
@@ -94,6 +123,22 @@ sequenceDiagram
|
|
|
94
123
|
|
|
95
124
|
---
|
|
96
125
|
|
|
126
|
+
## π± Mobile Remote Control (PWA)
|
|
127
|
+
|
|
128
|
+
<p align="center">
|
|
129
|
+
<img src="https://raw.githubusercontent.com/takkub/agent-takkub/main/assets/mobile-remote.png" alt="Takkub Remote β drive your Lead from your phone" width="300">
|
|
130
|
+
</p>
|
|
131
|
+
|
|
132
|
+
<div align="center"><i>Step away from the desk β pair your phone once (link / QR) and watch <b>and steer</b> the Lead from anywhere, through an install-free PWA.</i></div>
|
|
133
|
+
|
|
134
|
+
- **π² Install-free PWA** β open the paired link, *Add to Home Screen*, done. Offline-capable app shell, no store.
|
|
135
|
+
- **π¬ Live Lead console** β the Lead's replies stream to your phone in real time (with a "still workingβ¦" indicator); type back to steer it.
|
|
136
|
+
- **π Pulse** β a glanceable, project-grouped view of which teammates are running and for how long.
|
|
137
|
+
- **ποΈ View vs. control** β read-only by default; flip to control mode to send prompts or open projects remotely.
|
|
138
|
+
- **π Three-factor, off by default** β secret path + bearer token (never in the QR) + a password gate, on a loopback-only server behind a Cloudflare/ngrok tunnel, with per-client sessions & brute-force lockout. Data-minimized: never ships raw tool output, commands, or filesystem paths. Turn it on from the cockpit's **π Remote** chip.
|
|
139
|
+
|
|
140
|
+
---
|
|
141
|
+
|
|
97
142
|
## π οΈ Everyday Commands
|
|
98
143
|
|
|
99
144
|
| Command | Purpose |
|
|
@@ -114,11 +159,11 @@ sequenceDiagram
|
|
|
114
159
|
|
|
115
160
|
- ποΈ **Architecture & design** β [Architecture Guide](https://github.com/takkub/agent-takkub/blob/main/docs/ARCHITECTURE.md)
|
|
116
161
|
- βοΈ **System overview & flow diagrams** β [docs/system-overview](https://github.com/takkub/agent-takkub/tree/main/docs/system-overview)
|
|
117
|
-
- π§ **From source / one-shot installer** (Chrome, gh,
|
|
162
|
+
- π§ **From source / one-shot installer** (Chrome, gh, Codex, Antigravity, rtk, β¦) β [INSTALL.md](https://github.com/takkub/agent-takkub/blob/main/docs/INSTALL.md)
|
|
118
163
|
- π **GitHub** β [takkub/agent-takkub](https://github.com/takkub/agent-takkub)
|
|
119
164
|
|
|
120
165
|
---
|
|
121
166
|
|
|
122
167
|
<div align="center">
|
|
123
|
-
<sub>Windows & macOS β’ built on PyQt6 β’ powered by the Claude Code CLI β’ MIT</sub>
|
|
168
|
+
<sub>Windows & macOS β’ built on PyQt6 β’ powered by the Claude Code CLI β’ MIT-licensed</sub>
|
|
124
169
|
</div>
|