agency-cli 1.1.0 → 1.4.0

package/README.md

@@ -1,8 +1,7 @@
-![Agency Logo](./media/logo.svg)
-
 # Agency
 
-[![Release](https://img.shields.io/github/v/release/tobias-walle/agency?include_prereleases)](https://github.com/tobias-walle/agency/releases)
+![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)
 
@@ -11,7 +10,7 @@ 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
 
@@ -32,7 +31,7 @@ The easiest option is to use the TUI; run `agency tui` or just `agency`.
 Everything available in the TUI is also available via the CLI:
 
 - `agency --help` - See all available commands
-- `agency new my-task` - Start a new task with slug `my-task`; opens your `$EDITOR` to describe what the agent should do.
+- `agency new my-task` - Start a new task with slug `my-task`; opens your configured editor to describe what the agent should do.
 - `agency new --draft my-task` - Create a new task as a draft (doesn't start it yet).
 - `agency edit my-task` - Edit a draft task.
 - `agency start my-task` - Start a task that is a draft or stopped.
@@ -41,8 +40,9 @@ Everything available in the TUI is also available via the CLI:
 - `agency merge my-task` - Merge the task back into the base branch.
 - `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 tasks` - List all tasks and their status.
+- `agency config` - Open the global Agency config in your editor.
+- `agency daemon start|stop|restart` - Manage the background daemon that tracks sessions and notifies clients.
 - ... and many more (see `agency --help`).
 
 ## Configuration
@@ -53,6 +53,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.
@@ -66,6 +79,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).
 
@@ -76,24 +90,46 @@ cmd = ["<root>./my-local-agent", "-p", "$AGENCY_TASK"]
 
 Check out the [default config](./crates/agency/defaults/agency.toml) for a few examples.
 
+### Editor
+
+Control which editor Agency uses when opening files (e.g. task descriptions, worktrees, and config):
+
+```toml
+# Preferred editor argv. If unset, Agency falls back to $EDITOR, then to `vi`.
+editor = ["nvim"]
+
+# Examples:
+# editor = ["code", "-w"]
+# editor = ["zed", "--wait"]
+```
+
+You can also run `agency config` to open (and create if missing) the global config file directly in your editor.
+
 ## 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
@@ -107,16 +143,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

@@ -7,10 +7,10 @@
         "agency": "run-agency.js"
       },
       "dependencies": {
-        "axios": "^1.11.0",
+        "axios": "^1.12.2",
         "axios-proxy-builder": "^0.1.2",
         "console.table": "^0.10.0",
-        "detect-libc": "^2.0.4",
+        "detect-libc": "^2.1.2",
         "rimraf": "^6.0.1"
       },
       "devDependencies": {
@@ -22,7 +22,7 @@
       },
       "hasInstallScript": true,
       "name": "agency-cli",
-      "version": "1.1.0"
+      "version": "1.4.0"
     },
     "node_modules/@isaacs/balanced-match": {
       "engines": {
@@ -98,10 +98,10 @@
         "form-data": "^4.0.4",
         "proxy-from-env": "^1.1.0"
       },
-      "integrity": "sha512-1Lx3WLFQWm3ooKDYZD1eXmoGO9fxYQjrycfHFC8P0sCfQVXyROp0p9PFWBehewBOdCwHc+f/b8I0fMto5eSfwA==",
+      "integrity": "sha512-vMJzPewAlRyOgxV2dU0Cuz2O8zzzx9VYtbJOaBgXFeLc4IV/Eg50n4LowmehOOR61S8ZMpc2K5Sa7g6A4jfkUw==",
       "license": "MIT",
-      "resolved": "https://registry.npmjs.org/axios/-/axios-1.11.0.tgz",
-      "version": "1.11.0"
+      "resolved": "https://registry.npmjs.org/axios/-/axios-1.12.2.tgz",
+      "version": "1.12.2"
     },
     "node_modules/axios-proxy-builder": {
       "dependencies": {
@@ -217,10 +217,10 @@
       "engines": {
         "node": ">=8"
       },
-      "integrity": "sha512-3UDv+G9CsCKO1WKMGw9fwq/SWJYbI0c5Y7LU1AXYoDdbhE2AHQ6N6Nb34sG8Fj7T5APy8qXDCKuuIHd1BR0tVA==",
+      "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",
       "license": "Apache-2.0",
-      "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.0.4.tgz",
-      "version": "2.0.4"
+      "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
+      "version": "2.1.2"
     },
     "node_modules/dunder-proto": {
       "dependencies": {
@@ -895,5 +895,5 @@
     }
   },
   "requires": true,
-  "version": "1.1.0"
+  "version": "1.4.0"
 }

package/package.json

@@ -1,13 +1,13 @@
 {
-  "artifactDownloadUrl": "https://github.com/tobias-walle/agency/releases/download/v1.1.0",
+  "artifactDownloadUrl": "https://github.com/tobias-walle/agency/releases/download/v1.4.0",
   "bin": {
     "agency": "run-agency.js"
   },
   "dependencies": {
-    "axios": "^1.11.0",
+    "axios": "^1.12.2",
     "axios-proxy-builder": "^0.1.2",
     "console.table": "^0.10.0",
-    "detect-libc": "^2.0.4",
+    "detect-libc": "^2.1.2",
     "rimraf": "^6.0.1"
   },
   "description": "AI Agent Orchestrator in the terminal",
@@ -46,13 +46,6 @@
       },
       "zipExt": ".tar.xz"
     },
-    "x86_64-apple-darwin": {
-      "artifactName": "agency-x86_64-apple-darwin.tar.xz",
-      "bins": {
-        "agency": "agency"
-      },
-      "zipExt": ".tar.xz"
-    },
     "x86_64-unknown-linux-gnu": {
       "artifactName": "agency-x86_64-unknown-linux-gnu.tar.xz",
       "bins": {
@@ -61,7 +54,7 @@
       "zipExt": ".tar.xz"
     }
   },
-  "version": "1.1.0",
+  "version": "1.4.0",
   "volta": {
     "node": "18.14.1",
     "npm": "9.5.0"