EXEC

aep-caw Command Execution

When executing shell commands in this codebase, use aep-caw to run commands within a sandboxed session.

Syntax for Single Command Execution

Basic Form

aep-caw exec SESSION_ID -- COMMAND [ARGS...]

The -- separator is required between the session ID and the command.

Examples

aep-caw exec my-session -- ls -la
aep-caw exec my-session -- npm install
aep-caw exec my-session -- go build ./...

With Environment Variable (Preferred for Agents)

When AEP_CAW_SESSION_ID is set, all arguments after exec become the command:
export AEP_CAW_SESSION_ID=my-session
aep-caw exec -- ls -la
aep-caw exec -- npm install

Auto-Create Session on First Exec

If the session doesn't exist, use --root to auto-create it:
aep-caw exec my-session --root /path/to/workspace -- ls -la

Or set AEP_CAW_SESSION_ROOT:
export AEP_CAW_SESSION_ROOT=/path/to/workspace
aep-caw exec my-session -- ls -la

Common Flags

| Flag          | Description                                    |
|---------------|------------------------------------------------|
| --timeout 30s | Command timeout (e.g., 30s, 5m)                |
| --output json | JSON structured output instead of shell output |
| --stream      | Stream output as it's produced                 |
| --pty         | Interactive PTY mode                           |

Environment Variables

| Variable             | Description                                    |
|----------------------|------------------------------------------------|
| AEP_CAW_SESSION_ID   | Session ID to use (avoids passing as argument) |
| AEP_CAW_SESSION_ROOT | Root directory for auto-creating sessions      |
| AEP_CAW_SERVER       | Server URL (default: http://127.0.0.1:18080)    |