openaide

Manage AI agent workspaces using git worktrees, tmux, and opencode.

openaide wires together a git worktree, a tmux session, and an opencode AI agent into a fully isolated coding workspace — all from a single command. Each workspace lives in its own branch and directory, so multiple agents can work on different tasks in parallel without stepping on each other.

---

Prerequisites

The following must be installed and available on your PATH:

• git — for worktree management
• tmux — for session management
• opencode — the AI coding agent

---

Installation

npm install -g @trismegis7us/openaide

---

How it works

1. Git worktree — a new branch and working directory are created at ../.openaide/worktrees/<name>, fully isolated from your main checkout.
2. tmux session — a new tmux session named <name> is started, with its working directory set to the worktree.
3. opencode agent — the agent is launched inside the tmux session, seeded with the contents of your spec file or inline prompt.

---

CLI Reference

create [options] [name]

Create a new workspace which includes a git worktree and a coding agent.

• -s, --spec-file <specFile> — Markdown spec file to launch the workspace with.
• -p, --prompt <prompt> — Prompt to launch the workspace with.
• -v, --verbose — Enable verbose logging.

delete [options] [workspaces...]

Delete a workspace (worktree, branch, and tmux session).

• -v, --verbose — Enable verbose logging.

list [options]

List all active workspaces.

• --json — Format output as JSON.

spec [options] [command]

Manage spec files, dependency chains, priorities, and more.

run [options] [specFiles...]

Runs the create command with the given spec file.

ready [options]

List all specs that are ready to be worked on.

• -s, --spec-files <specFiles...> — Markdown spec files to analyze. Default is all.
• --json — Output as JSON