claude-agent

Claude Agent (wrapper)

This runs an autonomous agent with permission prompts disabled. The default permission mode is bypassPermissions, because a non-interactive run has no one to answer a prompt. The child agent can read, write and execute in whatever directory you launch it from. Only give it briefs you would be willing to run yourself, and set CLAUDE_PERMISSION_MODE if you want something stricter.

Execution

Works in both foreground and background:

# Foreground (blocks until done - use a long timeout, runs can take minutes)
Bash(command: "node \"~/.claude/skills/claude-agent/scripts/claude-agent.mjs\" Your prompt here", timeout: 600000)

# Background (non-blocking - you are notified when it finishes)
Bash(command: "node \"~/.claude/skills/claude-agent/scripts/claude-agent.mjs\" Your prompt here", run_in_background: true)

Background is preferred when launching multiple agents in parallel.

---

Thin wrapper around claude -p (Claude Code CLI) for non-interactive use:

• Provide the prompt via arguments, PROMPT_FILE, or stdin (briefs are byte-exact)
• Model selection via --model or CLAUDE_MODEL
• TRUE session resume via --resume / --continue or CLAUDE_SESSION
• Pre-assign a session id via --session-id so the caller owns the handle
• Opt-in live phase/liveness monitor via --monitor / CLAUDE_MONITOR=1
• Clean reply and session id read straight out of the JSON result — no scraping

Prerequisites

• Node 18 or newer (node --version)
• Claude Code CLI: npm install -g @anthropic-ai/claude-code

Nothing else. The wrapper is a single Node script with no dependencies, so it does not need bash, jq, python3, uuidgen, GNU grep or GNU sort. It runs the same on Linux, macOS, WSL, and Windows (PowerShell, cmd, or Git Bash).

Usage

# Arguments
node "~/.claude/skills/claude-agent/scripts/claude-agent.mjs" Your prompt here

# File via env var (preferred for big briefs - byte-exact off stdin)
PROMPT_FILE=task.md node "~/.claude/skills/claude-agent/scripts/claude-agent.mjs"

# Stdin
cat task.md | node "~/.claude/skills/claude-agent/scripts/claude-agent.mjs"