agency-cli 1.0.0 → 1.2.0

package/README.md

@@ -1,20 +1,23 @@
-![Agency Logo](./media/logo.svg)
-
 # Agency
 
+![Agency](./media/logo.svg)
+
+[![npm](https://img.shields.io/npm/v/agency-cli.svg?logo=npm&label=npm)](https://www.npmjs.com/package/agency-cli)
+![Platforms](https://img.shields.io/badge/platform-macOS%20%7C%20Linux-green)
+
 Agency is an AI agent orchestrator running purely in the command line.
 
 - User-friendly TUI heavily inspired by [Lazygit](https://github.com/jesseduffield/lazygit)
 - CLI commands for easy automation
 - Supports any CLI coding agent: [Claude Code](https://github.com/anthropics/claude-code), [Codex CLI](https://github.com/openai/codex), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [OpenCode](https://github.com/sst/opencode) and [you can add more](#defining-a-custom-agent)
-  - Isolated environments for each task using Git worktrees
+- Isolated environments for each task using [Git Worktrees](https://git-scm.com/docs/git-worktree) and [Tmux](https://github.com/tmux/tmux)
 
 ## Getting Started
 
 1. Install Agency with your preferred method (macOS and Linux supported)
-   - Build from source: `cargo install --git <url>`
-   - NPM (_Coming soon_): `npm install -g @tobias-walle/agency`
-   - Homebrew (_Coming soon_): `brew install tobias-walle/tap/agency`
+   - NPM: `npm install -g agency-cli`
+   - Homebrew : `brew install tobias-walle/tap/agency`
+   - Build from source: `cargo install --git https://github.com/tobias-walle/agency`
 2. Set up your preferences: `agency setup`
 3. Set up Agency in your project: `agency init`
 4. Start the TUI: `agency`
@@ -38,7 +41,7 @@ Everything available in the TUI is also available via the CLI:
 - `agency path my-task` - Get the worktree path for a task.
 - `agency shell my-task` - Open a shell in the task's worktree.
 - `agency ps` - List all tasks and their status.
-- `agency daemon start|stop|restart` - Manage the background daemon that runs the agents.
+- `agency daemon start|stop|restart` - Manage the background daemon that tracks sessions and notifies clients.
 - ... and many more (see `agency --help`).
 
 ## Configuration
@@ -49,6 +52,19 @@ Configuration is layered in three tiers:
 2. Global file `~/.config/agency/agency.toml` (created by `agency setup`)
 3. Project overrides at `./.agency/agency.toml`
 
+### Tmux
+
+Agency uses Tmux to manage the background agents.
+
+If you attach to an agent you are basically opening Tmux.
+
+Config precedence when starting sessions:
+
+1. User defaults (best-effort): `~/.tmux.conf`, then `~/.config/tmux/tmux.conf`
+2. Agency defaults (baseline UI/options applied programmatically)
+3. Agency global overrides: `~/.config/agency/tmux.conf`
+4. Project overrides: `./.agency/tmux.conf`
+
 ### Defining a custom agent
 
 You can define custom agents using any CLI command.
@@ -62,6 +78,7 @@ The following environment variables are injected into the command:
 
 - `$AGENCY_TASK` - The full prompt for the current task.
 - `$AGENCY_ROOT` - The path to the folder of the main repo (not the worktree).
+- `$AGENCY_TASK_ID` - The numeric ID of the task.
 
 You can also use the `<root>` placeholder for relative paths (works in any config in which you define a path).
 
@@ -74,22 +91,29 @@ Check out the [default config](./crates/agency/defaults/agency.toml) for a few e
 
 ## Architecture
 
-Agency uses a daemon + client architecture. The daemon manages all PTY sessions that run the agents. Clients (CLI or TUI) communicate with the daemon via a Unix socket.
+Agency uses a daemon + client architecture with tmux-managed sessions. The daemon is slim: it computes session/task status from tmux and broadcasts notifications. Clients (CLI or TUI) communicate with the daemon via a Unix socket but attach directly to tmux for interactive views.
 
-The socket is stored in one of the following locations:
+Daemon socket path precedence:
 
 - `$AGENCY_SOCKET_PATH` env override
 - `daemon.socket_path` in config
 - `$XDG_RUNTIME_DIR/agency.sock`
 - `~/.local/run/agency.sock` (Default)
 
+Tmux socket path precedence (used for all sessions):
+
+- `$AGENCY_TMUX_SOCKET_PATH` env override
+- `daemon.tmux_socket_path` in config
+- `$XDG_RUNTIME_DIR/agency-tmux.sock`
+- `~/.local/run/agency-tmux.sock` (Default)
+
 ```mermaid
 flowchart LR
   U[User] --> C[TUI/CLI]
   C <--> S[Unix Socket]
   S <--> D[Agency Daemon]
-  D --> P[PTY Sessions]
-  P --> A[CLI Agents]
+  C <--> T[tmux Server]
+  T --> A[CLI Agents]
 
   subgraph Project
     A
@@ -103,16 +127,15 @@ sequenceDiagram
   participant U as User
   participant C as Agency CLI
   participant D as Daemon
-  participant P as PTY Manager
+  participant T as tmux
   participant A as Agent
 
   U->>C: agency new my-task
   C->>C: Create .agency/tasks/my-task.md
-  C->>D: OpenSession(project, task, cmd, worktree) via socket
-  D->>P: Spawn PTY session
-  P->>A: Exec agent cmd in worktree
-  C->>P: Attach to session (interactive)
-  U<<->>P: Terminal I/O
-  P->>D: Status updates
-  D->>C: Notifications
+  C->>T: new-session -d -s agency-<id>-<slug> (remain-on-exit)
+  T->>A: Exec agent cmd in worktree
+  C->>T: attach-session -t agency-<id>-<slug>
+  U<<->>T: Terminal I/O
+  T->>D: (indirect) State via list-sessions/list-panes
+  D->>C: SessionsChanged/TasksChanged
 ```

package/npm-shrinkwrap.json

@@ -22,7 +22,7 @@
       },
       "hasInstallScript": true,
       "name": "agency-cli",
-      "version": "1.0.0"
+      "version": "1.2.0"
     },
     "node_modules/@isaacs/balanced-match": {
       "engines": {
@@ -895,5 +895,5 @@
     }
   },
   "requires": true,
-  "version": "1.0.0"
+  "version": "1.2.0"
 }

package/package.json

@@ -1,5 +1,5 @@
 {
-  "artifactDownloadUrl": "https://github.com/tobias-walle/agency/releases/download/v1.0.0",
+  "artifactDownloadUrl": "https://github.com/tobias-walle/agency/releases/download/v1.2.0",
   "bin": {
     "agency": "run-agency.js"
   },
@@ -61,7 +61,7 @@
       "zipExt": ".tar.xz"
     }
   },
-  "version": "1.0.0",
+  "version": "1.2.0",
   "volta": {
     "node": "18.14.1",
     "npm": "9.5.0"