aemeathcli 1.0.10 → 1.0.12

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AemeathCLI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -8,6 +8,7 @@
   Agent teams · Split-panel coordination · Role-based routing
   <br />
   <br />
+  <a href="https://aemeathcli.pages.dev"><img src="https://img.shields.io/badge/website-aemeathcli.pages.dev-34d399?style=flat-square" alt="Website" /></a>
   <a href="https://www.npmjs.com/package/aemeathcli"><img src="https://img.shields.io/npm/v/aemeathcli?style=flat-square&color=red" alt="npm" /></a>
   <a href="#installation"><img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen?style=flat-square" alt="Node.js >= 20" /></a>
   <a href="#license"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="MIT License" /></a>
@@ -20,11 +21,15 @@
 ```
   ╔══════════════════════════════════════════════╗
   ║           Welcome to AemeathCLI              ║
-  ║    Multi-Model CLI Coding Tool v1.0.0        ║
+  ║    Multi-Model CLI Coding Tool v1.0.10       ║
   ╚══════════════════════════════════════════════╝
 ```
 
-AemeathCLI orchestrates **multiple AI models** across **parallel agent teams** in your terminal. Route Claude for planning, GPT for coding, Gemini for reviews -- all in split-panel panes (iTerm2 native on macOS, tmux elsewhere) with real-time streaming, hub-and-spoke coordination, cost tracking, and enterprise-grade security.
+AemeathCLI orchestrates **multiple AI models** across **parallel agent teams** in your terminal. Route Claude for planning, GPT for coding, Gemini for reviews -- with real-time streaming, tmux-backed visual orchestration when enabled, cost tracking, and enterprise-grade security.
+
+<p align="center">
+  <img src="site/screenshots/home.jpg" alt="AemeathCLI launch screen" width="720" />
+</p>
 
 <br />
 
@@ -54,7 +59,7 @@ AemeathCLI orchestrates **multiple AI models** across **parallel agent teams** i
 Most AI coding tools lock you into a single model. AemeathCLI breaks that ceiling:
 
 - **Multi-model orchestration** -- Use the right model for each task. Claude Opus for architecture, GPT-5.2 for implementation, Gemini 2.5 Pro for code review -- in one session.
-- **Agent teams** -- Describe what you need in plain English and the LLM designs the team. Agents spawn in iTerm2/tmux split panes with a hub-and-spoke coordination model -- a leader orchestrates, teammates execute, and results are synthesized through a shared board.
+- **Agent teams** -- Describe what you need in plain English and the LLM designs the team. Agents can run under the orchestrator with tmux-backed visual panes when enabled, while a leader orchestrates, teammates execute, and results are synthesized through a shared board.
 - **Smart routing** -- Define role-based routing rules. When you switch to "review" mode, the system automatically picks the best model for reviewing code.
 - **Cost-aware** -- Real-time token counting, per-model cost tracking, configurable budget warnings and hard stops. Know exactly what you're spending.
 - **Skills & MCP** -- Extend functionality with YAML-defined skills and Model Context Protocol servers. Your tools, your workflow.
@@ -69,9 +74,11 @@ Most AI coding tools lock you into a single model. AemeathCLI breaks that ceilin
 npm install -g aemeathcli
 
 # Authenticate with your providers
-aemeathcli auth login claude
-aemeathcli auth login codex
-aemeathcli auth login gemini
+aemeathcli login
+
+# For orchestrator mode, also configure API keys
+export ANTHROPIC_API_KEY=your_key_here
+export OPENAI_API_KEY=your_key_here
 
 # Start coding
 aemeathcli "Refactor the authentication module to use JWT tokens"
@@ -87,8 +94,11 @@ That's it. AemeathCLI detects your project, picks the best model, and starts str
 
 - **Node.js** >= 20.0.0
 - **npm** >= 9 (or pnpm / yarn)
-- **tmux** (optional, for split-panel mode)
-- **iTerm2** (optional, macOS native pane support)
+- **tmux** (optional, for Linux split-panel swarm panes; macOS and Windows use native terminal splits)
+- Native build tools for Node modules such as `node-pty` and `better-sqlite3`
+  - macOS: Xcode Command Line Tools
+  - Linux: Python, make, and a C/C++ compiler
+  - Windows: Visual Studio Build Tools or an equivalent MSVC toolchain
 
 ### Install
 
@@ -102,7 +112,7 @@ The CLI installs two commands: `aemeathcli` and the shorthand `ac`.
 
 ```bash
 aemeathcli --version
-# 1.0.0
+# 1.0.10
 ```
 
 ### First Run
@@ -111,7 +121,7 @@ aemeathcli --version
 aemeathcli config init
 ```
 
-This launches an interactive setup wizard that walks you through provider authentication and initial configuration.
+This launches an interactive setup wizard that walks you through provider authentication, detects installed agent CLIs, and lets you choose the master provider used for swarm orchestration. SDK-backed swarm features still need `aemeathcli auth set-key <provider>` or matching environment variables when browser login is not enough.
 
 <br />
 
@@ -184,21 +194,26 @@ aemeathcli review src/auth/ src/api/middleware.ts
 aemeathcli test "Generate tests for the recent changes"
 ```
 
-### Team Mode
+### Swarm Mode
 
-Teams are created through **natural language** in the interactive chat -- no CLI subcommands needed:
+Swarm orchestration now lives inside the default TUI:
 
 ```bash
-# Start interactive session
+# Start the CLI
 aemeathcli
 
-# Then describe the team you need:
-> Create a team to refactor the authentication module
-> I need agents to review this PR from security, architecture, and code quality angles
-> Spawn a team to build the new payment feature with planning, coding, and testing
+# Or start with a first task
+aemeathcli "Refactor the authentication module"
 ```
 
-The LLM designs the optimal team (roles, models, agent count) and spawns each agent in its own split pane. On macOS with iTerm2, panes are native terminal splits. On Linux or inside tmux, panes use tmux splits. Stop a team with `/team stop`.
+Inside the TUI:
+
+- Press `Shift+Tab` to switch into swarm mode.
+- The onboarding flow detects supported native agent CLIs and stores your preferred master provider.
+- The master agent owns the left half of the split layout; worker agents stack on the right.
+- AemeathCLI automatically detects your terminal and projects the swarm into native split panes (iTerm2, Ghostty, Terminal.app on macOS; Windows Terminal on Windows; tmux on Linux) while keeping the same hub-and-spoke model.
+
+SDK-backed swarm planning still needs a tool-calling-capable provider, so browser login alone may not be enough; configure an API key or environment variable for the provider you want to sponsor the swarm.
 
 ```
 ┌───────────────────────┬───────────────────────┐
@@ -281,24 +296,40 @@ Customize routing in `~/.aemeathcli/config.json`:
 
 ## Agent Teams
 
-Create parallel agent teams through natural language. The LLM designs the team, split panes launch automatically, and agents coordinate via a hub-and-spoke model.
+Create parallel agent teams through the default swarm experience. The master agent sponsors specialized workers, optional tmux panes open when enabled, and every team follows a hub-and-spoke model.
 
 ### How It Works
 
-1. **Natural language creation** -- Describe the team you need ("Create a team to review the codebase"). No CLI subcommands or JSON config needed.
-2. **LLM-driven design** -- The active model decides the optimal team: agent count, names, roles, models, and task prompts -- all tailored to your request.
-3. **Split-panel mode** -- Each agent gets its own terminal pane (iTerm2 native splits on macOS, tmux splits on Linux/inside tmux).
-4. **Hub-and-spoke coordination** -- A lead agent orchestrates the effort. All agents share a board directory where they write outputs, read each other's work, and the lead synthesizes a final summary.
-5. **Cross-model teams** -- The LLM assigns different providers per agent: Claude Opus for planning, GPT Codex for coding, Gemini Pro for research -- all in one team.
+1. **Master-led orchestration** -- Start `aemeathcli`, press `Shift+Tab`, and describe the task. The configured master agent decomposes the work.
+2. **Profile-driven delegation** -- The supervisor chooses specialized worker profiles such as `developer`, `reviewer`, `tester`, and `architect`.
+3. **Split-panel mode** -- Each worker gets its own native terminal pane. Supports iTerm2, Ghostty, macOS Terminal.app, Windows Terminal, and tmux.
+4. **Hub-and-spoke coordination** -- A lead agent orchestrates the effort. Workers execute bounded tasks and results are synthesized by the supervisor.
+5. **Cross-model teams** -- Different providers can be assigned per worker: Claude for planning, Codex for coding, Gemini for documentation and testing.
 
 ### Split-Panel Backends
 
+AemeathCLI auto-detects your terminal and picks the best split backend:
+
 | Environment | Backend | How |
 |:------------|:--------|:----|
-| **macOS + iTerm2** | Native iTerm2 panes | AppleScript creates vertical/horizontal splits directly in your iTerm2 window |
-| **Inside tmux** | tmux splits | Auto-splits the current tmux window for each agent |
-| **Outside tmux (Linux)** | tmux session | Creates a new tmux session and attaches |
-| **No pane manager** | Single-pane fallback | Tab-based agent switching within the TUI |
+| **macOS — iTerm2** | AppleScript | Splits sessions via iTerm2's native AppleScript dictionary |
+| **macOS — Ghostty** | System Events | Simulates Ghostty keybindings (Cmd+D / Cmd+Shift+D) for hub-spoke splits |
+| **macOS — Terminal.app** | System Events | Simulates Cmd+D to create native split panes |
+| **Windows — Windows Terminal** | wt.exe | Uses `wt split-pane` commands for hub-spoke layout |
+| **Linux (any terminal)** | tmux | Creates or reuses a tmux session with split panes |
+| **Fallback** | In-process | Tab-switchable agent panels when no native pane support is detected |
+
+#### macOS — iTerm2 Split Panel
+
+<p align="center">
+  <img src="site/screenshots/mac-splitpanel.jpg" alt="iTerm2 split panel mode on macOS" width="720" />
+</p>
+
+#### Windows Terminal Split Panel
+
+<p align="center">
+  <img src="site/screenshots/win-splitpanel.jpg" alt="Windows Terminal split panel mode" width="720" />
+</p>
 
 ### Hub-and-Spoke Coordination
 
@@ -343,9 +374,11 @@ Each agent runs a different model selected by the LLM based on role suitability:
 
 | Action | How |
 |:-------|:----|
-| Create team | Natural language in chat: "Create a team to build X" |
-| View agents | Each agent has its own pane -- click or switch panes |
-| Stop team | `/team stop` in the leader pane |
+| Enter swarm mode | Start `aemeathcli` and press `Shift+Tab` |
+| Run one task | `aemeathcli "Build X"` then switch to swarm mode if needed |
+| Focus next agent | `Tab` |
+| Cycle input mode | `Shift+Tab` |
+| Stop the active team | `/team stop` |
 
 <br />
 
@@ -372,7 +405,7 @@ Create a `SKILL.md` file with YAML frontmatter:
 ---
 name: my-skill
 description: Custom skill for my workflow
-version: 1.0.0
+version: 1.0.10
 triggers:
   - $my-skill
   - my-skill
@@ -518,7 +551,7 @@ aemeathcli/
     tools/         Built-in tools (bash, read, write, edit, glob, grep, git, web-fetch)
     auth/          OAuth PKCE login, credential store, session management
     teams/         Agent process management, message bus, task store
-    panes/         tmux/iTerm2 integration, IPC hub, layout engine
+    panes/         Split-pane backends (iTerm2, Ghostty, Terminal.app, Windows Terminal, tmux), IPC hub, layout engine
     skills/        Skill loader, registry, executor
     mcp/           MCP client, server manager, tool bridge
     storage/       SQLite store, config store, conversation persistence
@@ -526,8 +559,6 @@ aemeathcli/
     utils/         Logger, sanitizer, path resolver, retry, token counter
 ```
 
-**99 source files** &middot; **~14,000 lines of TypeScript** &middot; **Zero `any` types** &middot; **Strict mode + all strict flags**
-
 ### Technology Stack
 
 | Layer | Technology |
@@ -584,25 +615,6 @@ npm run test           # Vitest
 npm run test:coverage  # With coverage report
 ```
 
-### Project Conventions
-
-- **Interfaces** use `I` prefix: `IModelInfo`, `IChatMessage`, `IToolResult`
-- **Error classes** extend `AemeathError` with structured error codes
-- **Type imports** use `import type { ... }` consistently
-- **No `any`** -- enforced by ESLint `no-explicit-any` + `no-unsafe-*` rules
-- **All `catch` blocks** use `catch (error: unknown)` or bare `catch {}`
-- **Barrel exports** via `index.ts` in each module
-
-<br />
-
 ## License
 
 MIT
-
-<br />
-
----
-
-<p align="center">
-  Built with Claude, GPT, and Gemini — orchestrated by AemeathCLI itself.
-</p>