Start a REPL session with driver-aware completion tracking. Use when you need to launch a Python, Node, Bash, or Zsh REPL that supports completion-aware input via axrepl input.
Start a REPL process in a daemon-backed session with automatic driver detection. The driver determines how axrepl input wraps scripts to detect completion.
axrepl run [OPTIONS] <CMD> [ARGS...]
| Option | Description |
|---|---|
--name NAME | Human-readable session name for easy reference later |
--driver DRIVER | Override REPL driver (python, node, bash, zsh) when auto-detection fails |
--cwd DIR | Working directory for the spawned REPL |
--env K=V | Set environment variables (repeatable) |
--json | Emit structured JSON response |
python, python3, pynode, nodejsbashzshThe driver is inferred from the command name. Use --driver when the command path is ambiguous (e.g., a custom wrapper script).
axrepl run --name py python3
axrepl run --name js node
axrepl run --name custom --driver python ./my-python-wrapper
axrepl run --name dev --cwd /path/to/project python3
--name for sessions you plan to reuse — it makes later --session references readable.--driver when the command name doesn't match a known REPL (e.g., custom wrappers or virtualenv paths).axrepl over axec for REPL workflows — it handles completion detection automatically via axrepl input.--json when parsing the output programmatically — it returns the session UUID, name, and detected driver.axrepl input — Send completion-aware scripts to the REPL session.axec run — For non-REPL commands or when you need --timeout/--stopword/--backend options.