dirijor CLI

dirijor is diri's command-line tool. It talks to the same background Engine as the app, so anything you script with it shows up in the window. Agents use it too: diri's hooks and MCP server run through it.

#Where it lives

The Engine also keeps a copy in ~/Library/Application Support/Dirijor/bin/dirijor on macOS. Agents that diri starts get its path in $DIRIJOR_CLI, along with $DIRIJOR_SESSION_ID for their own session.

To use it from your own terminal on macOS, link it onto your PATH:

mkdir -p ~/.local/bin
ln -sf /Applications/diri.app/Contents/Resources/bin/dirijor ~/.local/bin/dirijor

The CLI finds the Engine through its socket. Set DIRIJOR_SOCKET to point at a different one.

#Conventions

• Targets. Most session commands take a target: a full session id, a unique id prefix, or a unique part of the session title (case-insensitive). Commands documented with ID need the id itself.
• --json. Prints one line of JSON instead of a table.
• Arguments are literal. session run passes everything after -- as separate arguments. Nothing is run through a shell.

#Exit codes

#Overview

dirijor hook, dirijor notify JSON and dirijor mcp-stdio are called by agents that diri launches. You do not need to run them.

#Sessions

dirijor session with no action is the same as dirijor session list.

--name is accepted as an alias for --title. --host takes a host id from your remote hosts.

#Wait statuses

#Keys

KEY is a single character or one of enter (or return), escape (or esc), tab, backspace, delete, insert, home, end, up, down, left, right, pageup, pagedown, f1 to f12. Use keypad:0 to keypad:9 for the numeric keypad.

#Worktrees

REPO defaults to the current folder.

See Worktrees and review.

#Workspaces, tabs and panes

These commands change the layout the app shows. Each one prints the new layout as JSON. Add --revision N to fail if someone else changed the layout first.

#Events

#Notes

dirijor note TEXT writes a quick note for the current project. The first line is its title.

NOTE is a note id or part of its title.

#Notifications

dirijor notify --title TEXT --body TEXT prints a notification escape sequence to the terminal, so it works in local and remote sessions without a socket. diri shows it like an agent notification.

#MCP from the shell

dirijor mcp-tools prints every tool the MCP server offers. dirijor mcp-call --tool NAME reads the tool's input as JSON from stdin and prints {"ok": ...} or {"error": ...}. Write tools need a live diri session identity, so call them from inside a diri session. See the MCP tool reference and the security model.

#Examples

These work in fish, zsh and bash.

Find sessions waiting for you:

dirijor session list --status needsInput

Start Codex in a new worktree with a task, then wait for it to finish:

dirijor session spawn codex --worktree --branch fix-login --title fix-login --prompt "Fix the failing login test"
dirijor session wait fix-login --until done --until needsInput --timeout 1800

Read the last 20 lines of a session's screen:

dirijor session read fix-login --lines 20

Run tests in their own terminal session and wait until the command exits:

dirijor session run --title tests -- cargo test --workspace
dirijor session wait tests --until exited

Dismiss a prompt with Escape, then send a follow-up. session key needs the exact id from session list; replace SESSION_ID with it:

dirijor session key SESSION_ID escape
dirijor session send fix-login "Use the existing helper instead"

Pipe a file into a new note:

cat plan.md | dirijor note add --title "Release plan" --pin