agentty is one binary with a handful of subcommands and flags.
Running
agentty # run in the current directory
agentty --workspace ~/code/project # run against another workspace
agentty -k sk-ant-… # single-session key, never written to disk
Subcommands
Command
What it does
agentty
Start an interactive thread in the workspace.
agentty login
Authenticate non-interactively (useful over SSH).
agentty logout
Clear stored credentials.
agentty status
Print which auth source will be used.
agentty airgap user@host
Run the agent on a remote host through an SSH SOCKS tunnel.
agentty --version
Print agentty <version> and exit.
agentty --help
Print usage and exit.
Common flags
Flag
Effect
-k, --key <key>
Use this API key for one session; never written to disk.
--workspace <path>
Set the workspace root without cd.
-V, --version
Print the build version and exit.
--setup
(airgap) Copy credentials to the remote on first run.
--remote-agentty <path>
(airgap) Path to agentty on the remote if not on PATH.