@8gi-foundation/8gent-code 0.6.0 → 0.8.1

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 +62 -89
  2. package/dist/cli.js +3282 -3189
  3. package/package.json +5 -5
  4. package/bin/8gent-run.js +0 -47
package/README.md CHANGED
@@ -12,15 +12,15 @@
12
12
 
13
13
  <p align="center">
14
14
  <a href="https://8gentjr.com"><img src="https://img.shields.io/badge/Jr-Live-2D8A56?style=for-the-badge&labelColor=1A1612" alt="Jr Live" /></a>
15
- <a href="https://8gentos.com"><img src="https://img.shields.io/badge/OS-In_Dev-E8610A?style=for-the-badge&labelColor=1A1612" alt="OS In Dev" /></a>
16
15
  <a href="https://github.com/8gi-foundation/8gent-code"><img src="https://img.shields.io/badge/Code-Open_Source-2D8A56?style=for-the-badge&labelColor=1A1612" alt="Code Open Source" /></a>
17
- <a href="https://8gent.world"><img src="https://img.shields.io/badge/World-Live-2D8A56?style=for-the-badge&labelColor=1A1612" alt="World Live" /></a>
18
- <a href="https://8gent.games"><img src="https://img.shields.io/badge/Games-Live-2D8A56?style=for-the-badge&labelColor=1A1612" alt="Games Live" /></a>
16
+ <a href="https://8gentos.com"><img src="https://img.shields.io/badge/OS-In_Dev-E8610A?style=for-the-badge&labelColor=1A1612" alt="OS In Dev" /></a>
17
+ <a href="https://8gent.world"><img src="https://img.shields.io/badge/World-In_Dev-E8610A?style=for-the-badge&labelColor=1A1612" alt="World In Dev" /></a>
18
+ <a href="https://8gent.games"><img src="https://img.shields.io/badge/Games-In_Dev-E8610A?style=for-the-badge&labelColor=1A1612" alt="Games In Dev" /></a>
19
19
  </p>
20
20
 
21
21
  <p align="center">
22
22
  <a href="https://www.apache.org/licenses/LICENSE-2.0"><img src="https://img.shields.io/badge/License-Apache_2.0-E8610A?style=for-the-badge&labelColor=1A1612" alt="Apache 2.0 License" /></a>
23
- <a href="https://8gent.dev"><img src="https://img.shields.io/badge/version-0.3.0-2D8A56?style=for-the-badge&labelColor=1A1612" alt="v2.0.0" /></a>
23
+ <a href="https://8gent.dev"><img src="https://img.shields.io/badge/version-0.8.1-2D8A56?style=for-the-badge&labelColor=1A1612" alt="v0.8.1" /></a>
24
24
  <a href="https://eight-vessel.fly.dev"><img src="https://img.shields.io/badge/daemon-Fly.io_Amsterdam-E8610A?style=for-the-badge&labelColor=1A1612" alt="Daemon" /></a>
25
25
  </p>
26
26
 
@@ -32,7 +32,7 @@
32
32
 
33
33
  ## The Ecosystem
34
34
 
35
- <p align="center"><sub>6 products &nbsp;·&nbsp; 6 domains &nbsp;·&nbsp; 1 constitution</sub></p>
35
+ <p align="center"><sub>2 shipped &nbsp;·&nbsp; 5 in development &nbsp;·&nbsp; 1 constitution</sub></p>
36
36
 
37
37
  <br />
38
38
 
@@ -40,29 +40,29 @@
40
40
  <tr>
41
41
  <td valign="top" width="33%">
42
42
 
43
- **8gent OS** -[8gentos.com](https://8gentos.com)<br />
44
- <sub>Parent site. Paid product. Revenue engine.</sub>
45
-
46
43
  **8gent Code** -[8gent.dev](https://8gent.dev)<br />
47
- <sub>Open source developer agent. Free on-ramp. <em>(this repo)</em></sub>
44
+ <sub>Open source developer agent. Free on-ramp. Shipped. <em>(this repo)</em></sub>
45
+
46
+ **8gent Jr** -[8gentjr.com](https://8gentjr.com)<br />
47
+ <sub>AI assistant for kids. Accessibility first. Free forever. Shipped.</sub>
48
48
 
49
49
  </td>
50
50
  <td valign="top" width="33%">
51
51
 
52
- **8gent** -[8gent.app](https://8gent.app)<br />
53
- <sub>Consumer GUI client for the OS.</sub>
52
+ **8gent OS** -[8gentos.com](https://8gentos.com)<br />
53
+ <sub>Paid personal OS. In development.</sub>
54
54
 
55
- **8gent World** -[8gent.world](https://8gent.world)<br />
56
- <sub>Ecosystem story, docs, <a href="https://8gent.world/media/decks">14 presentation decks</a>.</sub>
55
+ **8gent** -[8gent.app](https://8gent.app)<br />
56
+ <sub>Single pane of glass dashboard. In development.</sub>
57
57
 
58
58
  </td>
59
59
  <td valign="top" width="33%">
60
60
 
61
- **8gent Games** -[8gent.games](https://8gent.games)<br />
62
- <sub>Agent simulation playground.</sub>
61
+ **8gent World** -[8gent.world](https://8gent.world)<br />
62
+ <sub>Ecosystem story, docs, <a href="https://8gent.world/media/decks">presentation decks</a>. In development.</sub>
63
63
 
64
- **8gent Jr** -[8gentjr.com](https://8gentjr.com)<br />
65
- <sub>AI assistant for kids. Accessibility first. Free forever.</sub>
64
+ **8gent Games** -[8gent.games](https://8gent.games)<br />
65
+ <sub>Agent simulation playground. In development.</sub>
66
66
 
67
67
  </td>
68
68
  </tr>
@@ -150,29 +150,18 @@ npm install -g @8gi-foundation/8gent-code
150
150
  8gent
151
151
  ```
152
152
 
153
- That's it. Ollama runs locally by default - if you don't have it, 8gent will guide you through setup on first launch.
153
+ That's it. 8gent uses an adaptive 11-provider router. Default active provider is `8gent` local (model `eight-1.0-q3:14b`) with `ollama` also enabled by default. Cloud providers (OpenRouter, Groq, OpenAI, Anthropic, Mistral, Together, Fireworks, Replicate, Grok) are opt-in via API key. Failover chain: local 8gent, then local Qwen, then OpenRouter free tier.
154
154
 
155
- ## Quick Start (Harness Smoke)
155
+ ## Quick Start (from source)
156
156
 
157
157
  ```bash
158
- # 1. Clone and install
159
158
  git clone https://github.com/8gi-foundation/8gent-code.git
160
159
  cd 8gent-code
161
160
  bun install
162
-
163
- # 2. Verify CLI works
164
- bun run cli -- --version
165
- # Expected: 0.x.x (8gent Code)
166
-
167
- # 3. Verify harness typecheck
168
- bun run check:harness
169
- # Expected: exit 0 (or type errors listed — not a crash)
161
+ bun run tui
170
162
  ```
171
163
 
172
- If Ollama is not installed, 8gent will prompt you on first run. For offline/CI use:
173
- ```bash
174
- INFERENCE_MODE=proxy bun run cli -- --version
175
- ```
164
+ If no local model is available, 8gent will guide you through interactive onboarding on first run. The adaptive provider router tries local 8gent, then Ollama, then OpenRouter free tier.
176
165
 
177
166
  <br />
178
167
 
@@ -223,7 +212,7 @@ bun run tui
223
212
  <br />
224
213
 
225
214
  **Model-agnostic**<br />
226
- <sub>Auto-selects from best free models on OpenRouter. Runs Qwen 3.5 via Ollama locally. Task router classifies prompts (code / reasoning / simple / creative) and picks the best model automatically.</sub>
215
+ <sub>Adaptive 11-provider router: 8gent local, Ollama, OpenRouter, Groq, OpenAI, Anthropic, Mistral, Together, Fireworks, Replicate, Grok. Everything except 8gent/ollama is opt-in via API key. Task router classifies prompts (code, reasoning, simple, creative) and picks the best model automatically.</sub>
227
216
 
228
217
  <br />
229
218
 
@@ -254,7 +243,7 @@ bun run tui
254
243
  <br />
255
244
 
256
245
  **Voice**<br />
257
- <sub>8 neural AI voices (KittenTTS, free, local) + full-duplex via Moshi on Apple Silicon. Auto-installed during onboarding. <code>/voice chat</code> to start.</sub>
246
+ <sub>macOS TTS voices (Moira, Daniel, Samantha, Karen, Rishi) with KittenTTS neural voices as optional upgrade. Full-duplex Moshi backend scaffolded for Apple Silicon. <code>/voice chat</code> to start.</sub>
258
247
 
259
248
  <br />
260
249
 
@@ -371,6 +360,7 @@ See [packages/pet/README.md](packages/pet/README.md) for the full bestiary.
371
360
 
372
361
  | Deck | Link |
373
362
  |------|------|
363
+ | **Feature Set Audit** | [8gent.world/media/decks/feature-set](https://8gent.world/media/decks/feature-set) |
374
364
  | **npm Launch** | [8gent.world/media/decks/npm-launch](https://8gent.world/media/decks/npm-launch) |
375
365
  | **Lil Eight Pets** | [8gent.world/media/decks/lil-eight](https://8gent.world/media/decks/lil-eight) |
376
366
  | **Companion System** | [8gent.world/media/decks/companion-system](https://8gent.world/media/decks/companion-system) |
@@ -385,30 +375,15 @@ See [packages/pet/README.md](packages/pet/README.md) for the full bestiary.
385
375
 
386
376
  ## Voice
387
377
 
388
- Two modes: half-duplex voice chat and full-duplex conversation.
389
-
390
378
  **Half-duplex** (`/voice chat`) - listen, transcribe, think, speak, repeat. Requires sox and whisper.cpp:
391
379
 
392
380
  ```bash
393
381
  brew install sox whisper-cpp
394
382
  ```
395
383
 
396
- **Neural TTS** - 8 local AI voices via KittenTTS (free, no API key). Auto-offered during onboarding:
397
-
398
- | Voice | Gender | Character |
399
- |:------|:-------|:----------|
400
- | **Bruno** (default) | Male | Warm, authoritative |
401
- | Bella | Female | Warm, clear |
402
- | Jasper | Male | Crisp, technical |
403
- | Luna | Female | Soft, creative |
404
- | Rosie | Female | Bright, energetic |
405
- | Hugo | Male | Neutral, steady |
406
- | Kiki | Female | Light, friendly |
407
- | Leo | Male | Rich, expressive |
384
+ **TTS output** - macOS `say` voices (Moira, Daniel, Samantha, Karen, Rishi) work out of the box. KittenTTS neural voices (8 voices, free, local) are available as an optional upgrade - offered during onboarding.
408
385
 
409
- Falls back to macOS `say` (Moira, Daniel, Samantha, Karen, Rishi) if KittenTTS is not installed.
410
-
411
- **Full-duplex** - simultaneous listen and speak via Moshi (Kyutai) on Apple Silicon. Requires `pip install moshi`. Backend auto-detected.
386
+ **Full-duplex** (experimental) - simultaneous listen and speak via Moshi (Kyutai) on Apple Silicon. Backend code exists in `packages/voice/backends/moshi-mlx.ts` but requires manual setup (`pip install moshi`).
412
387
 
413
388
  <sub>Status bar shows: <strong>VOICE CHAT (listening)</strong> / <strong>SPEAKING</strong> / <strong>THINKING</strong></sub>
414
389
 
@@ -439,7 +414,7 @@ User prompt
439
414
 
440
415
  ## Benchmarks
441
416
 
442
- <p align="center"><sub>Execution-graded tests across professional domains. All local inference via Ollama.<br />Code compiles and runs against <code>bun:test</code> suites, or it fails. No string matching, no vibes.</sub></p>
417
+ <p align="center"><sub>Execution-graded tests across professional domains. Local inference via the adaptive router (8gent / Ollama defaults).<br />Code compiles and runs against <code>bun:test</code> suites, or it fails. No string matching, no vibes.</sub></p>
443
418
 
444
419
  <br />
445
420
 
@@ -479,12 +454,12 @@ CATEGORY=battle-test bun run benchmark:loop # autoresearch loop
479
454
 
480
455
  ```
481
456
  apps/
482
- tui/ Ink v6 terminal UI (main interface)
457
+ tui/ Ink v6 terminal UI (main interface, shipped)
483
458
  clui/ Tauri 2.0 desktop overlay (scaffolded)
484
- dashboard/ Next.js admin panel
485
- debugger/ Session debugger
459
+ dashboard/ Next.js admin panel (scaffolded)
460
+ debugger/ Session debugger (scaffolded)
486
461
  demos/ Remotion video generation
487
- installer/ Interactive install wizard
462
+ installer/ Interactive install wizard (shipped)
488
463
  ```
489
464
 
490
465
  </td>
@@ -494,26 +469,27 @@ apps/
494
469
 
495
470
  ```
496
471
  packages/
497
- eight/ Core agent engine (Vercel AI SDK)
498
- daemon/ Persistent vessel daemon (Fly.io)
499
- ai/ Provider abstraction (Ollama, OpenRouter)
500
- memory/ SQLite + FTS5 persistent memory
501
- orchestration/ WorktreePool, macro actions
502
- permissions/ NemoClaw YAML policy engine
503
- self-autonomy/ Evolution, reflection, HyperAgent
504
- validation/ Self-healing executor
505
- proactive/ Business agents, opportunity scanner
506
- ast-index/ Blast radius engine
507
- tools/ Browser, actuators, filesystem, shell
508
- voice/ STT (whisper.cpp) + TTS (KittenTTS/macOS) + full-duplex (Moshi)
509
- kernel/ RL fine-tuning pipeline (off by default)
510
- personality/ Brand voice, "Infinite Gentleman"
511
- telegram/ Telegram bot portal
512
- auth/ Clerk auth + GitHub integration
513
- db/ Convex reactive database
514
- control-plane/ Multi-tenant management
515
- board-plane/ Board-level vessel orchestration
516
- board-vessel/ Autonomous AI officer blueprint
472
+ eight/ Core agent engine (Vercel AI SDK) - shipped
473
+ providers/ 11-provider adaptive router + failover - shipped
474
+ memory/ SQLite + FTS5 persistent memory - shipped
475
+ orchestration/ WorktreePool, role registry, macro actions - shipped
476
+ permissions/ NemoClaw YAML policy engine - shipped
477
+ self-autonomy/ Evolution, reflection, HyperAgent - shipped
478
+ validation/ Self-healing executor - shipped
479
+ proactive/ Business agents, opportunity scanner - shipped
480
+ ast-index/ Blast radius engine - shipped
481
+ tools/ 75 tools: filesystem, shell, git, browser, AST - shipped
482
+ voice/ STT (whisper.cpp) + TTS (macOS/KittenTTS) - partial
483
+ kernel/ RL fine-tuning pipeline (off by default) - shipped
484
+ personality/ Brand voice, "Infinite Gentleman" - shipped
485
+ pet/ Companion system + dock pet - shipped
486
+ telegram/ Telegram bot portal - shipped
487
+ daemon/ Persistent vessel daemon (Fly.io) - partial
488
+ auth/ Clerk auth + GitHub integration - scaffolded
489
+ db/ Convex reactive database - scaffolded
490
+ control-plane/ Multi-tenant management - scaffolded
491
+ board-plane/ Board-level vessel orchestration - scaffolded
492
+ board-vessel/ Autonomous AI officer blueprint - scaffolded
517
493
  ```
518
494
 
519
495
  </td>
@@ -536,10 +512,10 @@ packages/
536
512
 
537
513
  ### Now
538
514
 
539
- - **Harness hardening** - brain/hands isolation, context compression, and sub-agent spawn protocol landed. Security audit on spawn governance in progress (#1409).
540
- - **Skill compounding** - tasks become reusable skills. Refining quality gate and promotion logic.
541
- - **Voice mode** - KittenTTS neural voices integrated. Full-duplex Moshi backend working on Apple Silicon. Evaluating PersonaPlex (NVIDIA) for persona-controlled voice.
542
- - **AST-index expansion** - symbol-level call edges, reachability queries, dead-code detection (#1392-#1394).
515
+ - **Per-tab model routing** - each agent tab (Orchestrator/Engineer/QA) gets its own provider and model, with Apple Foundation as lightweight chat option
516
+ - **Documentation sweep** - aligning all docs, README, and live sites with audited feature set
517
+ - **PR cleanup** - merging 12+ pending PRs with verification
518
+ - **Voice hardening** - KittenTTS integration, full-duplex Moshi backend stabilization
543
519
 
544
520
  </td>
545
521
  <td valign="top" width="33%">
@@ -548,7 +524,7 @@ packages/
548
524
 
549
525
  - **MCP server support** - expose 8gent tools as MCP servers for external agent consumption
550
526
  - **Context window compaction** - smarter compression beyond token threshold
551
- - **Extension system** - ExtensionCrafter for autonomous source-to-extension generation (#1254)
527
+ - **Extension system** - ExtensionCrafter for autonomous source-to-extension generation
552
528
  - [HyperAgent meta-improvement loop](docs/HYPERAGENT-SPEC.md)
553
529
  - [Kernel fine-tuning pipeline](docs/KERNEL-FINETUNING.md) activation
554
530
 
@@ -561,7 +537,7 @@ packages/
561
537
  - Multi-tenant control plane via 8GI gateway
562
538
  - Full autonomous issue resolution
563
539
  - Personal LoRA from session training pairs
564
- - 8gent Jr voice vessel (KittenTTS server-side for mobile clients)
540
+ - Dead code cleanup (music/DJ package)
565
541
 
566
542
  </td>
567
543
  </tr>
@@ -582,12 +558,12 @@ packages/
582
558
  | Command | What it does |
583
559
  |:--------|:-------------|
584
560
  | `/voice chat` | Start voice conversation mode |
585
- | `/voice start` | Push-to-talk recording |
586
561
  | `/model <name>` | Switch LLM model |
587
- | `/board` | Kanban task board |
562
+ | `/provider <name>` | Switch LLM provider |
563
+ | `/kanban` | Kanban task board |
588
564
  | `/predict` | Confidence-scored step predictions |
589
- | `/momentum` | Velocity stats |
590
565
  | `/evidence` | Session evidence summary |
566
+ | `/router` | Task router + model selection |
591
567
 
592
568
  </td>
593
569
  <td valign="top" width="50%">
@@ -601,11 +577,8 @@ packages/
601
577
  | `/auth status` | Check auth state |
602
578
  | `/debug` | Session inspector |
603
579
  | `/deploy <target>` | Deploy to Vercel/Railway/Fly |
604
- | `/throughput` | Token throughput stats |
605
- | `/scorecard` | Ability scorecard metrics |
606
- | `/soul` | Current persona calibration |
607
- | `/router` | Task router + model selection |
608
580
  | `/music` | Toggle lofi music (ADHD mode) |
581
+ | `/pet` | Companion dock pet |
609
582
  | `/rename` | Rename the current session |
610
583
 
611
584
  </td>