Rexa Docs
Esc

    Reference

    CLI

    The rexa command. Open projects, update, manage agents and extensions, and control the running app.

    The installer links rexa at ~/.local/bin/rexa. It opens projects, updates the app, and talks to the running Rexa. Agents use some of the same commands from inside Rexa terminals.

    Terminal
    rexa open .              # open this folder in Rexa
rexa version             # version and build
rexa update              # install the latest version
rexa claude setup --check

    rexa <path> does not open a folder; use rexa open <path>.

    App

    Command Flags Does
    rexa open [path] Open a folder as a project. Launches Rexa if it is not running. Default ..
    rexa version Print the version and build.
    rexa update --yes Check, download, verify, install and relaunch.
    rexa update check Exit code 10 when an update is available, 0 otherwise.
    rexa update migrate --check, --force Rerun saved-state migrations. A recovery tool.
    rexa uninstall --dry-run, --yes Remove Rexa and its data. Lists everything first.

    Agents

    Command Flags Does
    rexa <agent> setup --check, --remove, --json Install, check or remove an agent’s hooks and skill links. Agents: claude, codex, cursor, opencode, pi.
    rexa <agent> sessions --json List the agent’s sessions.
    rexa <agent> skills, mcps, hooks, memories --json List what the agent loads.
    rexa <agent> help List that agent’s commands.
    rexa agent ls --json Live agents. * marks the one in this terminal.
    rexa agent send <card> [message] --max-wait <time>, --force Message a live agent. Reads stdin without a message.
    rexa sessions --json List agent cards.
    rexa sessions remove <id> Forget a stuck card. Never stops a process.

    Extensions

    Command Flags Does
    rexa extension ls --json Installed extensions and what they add.
    rexa extension info <id> --json Show an extension’s manifest.
    rexa extension search zed:<query> --json Search Zed’s registry.
    rexa extension install <path|zed:id> --version, --copy, --force, --yes Install a local folder or a Zed extension.
    rexa extension remove <id> --yes Remove an installed extension.
    rexa extension enable <id>, disable <id> Turn an extension on or off.
    rexa extension outdated --json Zed extensions with newer releases.
    rexa extension logs [id] --follow, --count <n>, --level <level> Extension log lines. Works with Rexa closed.

    Terminals

    Command Flags Does
    rexa pty ls --all List the background terminals.
    rexa pty kill <id> End one terminal.
    rexa pty stop --yes Stop the background terminal process and its shells.

    Language servers

    rexa lsp with no subcommand prints every server’s status.

    Command Does
    rexa lsp diagnostics [path] Errors and warnings.
    rexa lsp restart [server], stop, start Control servers.
    rexa lsp trace <server> on|off Log every message to and from a server.
    rexa lsp toolchain [language] [choice] Show or pick a toolchain.
    rexa lsp hover <path:line:col> Hover text at a position.
    rexa lsp definition <path:line:col> Jump target. --kind declaration|type|implementation.

    GitHub and GitLab

    rexa forge prints read-only JSON from the host, through gh or glab: whoami, repo, pulls, pull, checks, threads, issues, issue, runs, run, log and more. Agents use it to read review threads and CI logs.

    Browser

    rexa web drives a Rexa browser tab. See the rexa web reference.

    Used by agents and hooks

    These run inside Rexa terminals and from agent hooks. You rarely call them yourself.

    Command Does
    rexa context Print the session context. Empty outside a Rexa terminal.
    rexa post <endpoint> Send stdin to an extension. Never fails the caller.
    rexa skills check, install Check or link extension skills into ~/.claude/skills.

    Global options

    --version, -V

    Print the version.

    --namespace, -n<name>

    Talk to another Rexa instance. Defaults to REXA_NAMESPACE, then the installed app.