damson-cli
damson-cli is a small command-line client that talks to a running Damson
instance over a local socket. It’s there for scripted control — automating your
workspace, or letting an AI agent drive the terminal.
Install
The binary ships inside the app bundle. Symlink it onto your PATH:
ln -s "/Applications/Damson.app/Contents/Resources/damson-cli" /usr/local/bin/damson-cliConfirm it’s wired up:
damson-cli --helpdamson-cli controls an already-running Damson app by sending it commands
over IPC. Start Damson first, then drive it from the CLI.
What it’s for
- Scripting your workspace — open tabs and panes, apply layouts, and send input as part of a shell script.
- AI orchestration — let a coding agent open panes and run commands in a real terminal it can see and control.
Related: the control library
Under the hood, damson-cli speaks to Damson through a small IPC wire library
(DamsonControl) that the app exposes. If you’re building deeper automation, the
same channel is what the orchestration engine uses to drive sessions — see
Orchard, the multi-agent app built on it.
Damson is in active beta; the exact damson-cli subcommands and flags are
evolving. Run damson-cli --help against your installed build for the
authoritative, up-to-date command list.