القائمة
Start a persistent background session with axec. Use when you need to launch a long-running command, REPL (Python, Node, etc.), shell, or background job that persists across CLI calls.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Remove exited REPL sessions and their on-disk state. Use after killing REPL sessions or when finished with completed REPL jobs.
Send a script to a REPL session with completion-aware execution. Use when you need to execute code in a Python, Node, Bash, or Zsh REPL and reliably capture the full output without guessing timeouts.
Force-kill a running REPL session or all sessions. Use when you need to stop REPL processes managed by axrepl.
List known REPL sessions with their driver info. Use when you need to see which REPL sessions exist and their status.
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.
Interactively attach to a running axec session for direct terminal access. Use when you need full interactive control of a session (like tmux attach).
| name | axec-run |
| description | Start a persistent background session with axec. Use when you need to launch a long-running command, REPL (Python, Node, etc.), shell, or background job that persists across CLI calls. |
| tools | Bash |
Start a command in a daemon-backed background session. The process persists after the CLI returns, allowing later input/output interaction.
axec run [OPTIONS] <CMD> [ARGS...]
| Option | Description |
|---|---|
--name NAME | Human-readable session name for easy reference later |
--timeout SECONDS | Stream early output for N seconds before returning |
--stopword REGEX | Stream output until regex matches, then return |
--terminate | Kill the session after timeout/stopword triggers |
--backend pty|pipe|auto | I/O backend (default: pty) |
--cwd DIR | Working directory for the command |
--env K=V | Set environment variables (repeatable) |
--json | Emit structured JSON response |
axec run --name py python3
axec run --name shell bash
axec run --name build --backend pipe sh -c 'echo out; echo err >&2'
axec run --name server --timeout 5 node server.js
axec run --name dev --cwd /path/to/project --env NODE_ENV=development node app.js
axec run --name check --backend auto sh -c 'echo ok; echo warn >&2; sleep 1'
--name for sessions you plan to reuse — it makes later --session references readable.--backend pipe for non-interactive commands when you need separate stdout/stderr.--timeout when you want to verify the process started correctly before moving on.--json when parsing the output programmatically — it returns the session UUID and metadata.axec list first to avoid creating duplicate sessions with the same name.