aivrar/portable-hermes-agent/claude-code
Claude Code and agent skill by aivrar/portable-hermes-agent
- community
Checking that the SKILL.md file is still in the repository.
Delegate coding to Claude Code CLI (features, PRs).
Install
npx vskill@latest install aivrar/portable-hermes-agent/claude-codeSKILL.md
Claude Code — Hermes Orchestration Guide
Delegate coding tasks to Claude Code (Anthropic's autonomous coding agent CLI) via the Hermes terminal. Claude Code v2.x can read files, write code, run shell commands, spawn subagents, and manage git workflows autonomously.
Prerequisites
- Install:
npm install -g @anthropic-ai/claude-code - Auth: run
claudeonce to log in (browser OAuth for Pro/Max, or setANTHROPIC_API_KEY) - Console auth:
claude auth login --consolefor API key billing - SSO auth:
claude auth login --ssofor Enterprise - Check status:
claude auth status(JSON) orclaude auth status --text(human-readable) - Health check:
claude doctor— checks auto-updater and installation health - Version check:
claude --version(requires v2.x+) - Update:
claude updateorclaude upgrade
Two Orchestration Modes
Hermes interacts with Claude Code in two fundamentally different ways. Choose based on the task.
Mode 1: Print Mode (-p) — Non-Interactive (PREFERRED for most tasks)
Print mode runs a one-shot task, returns the result, and exits. No PTY needed. No interactive prompts. This is the cleanest integration path.
When to use print mode:
- One-shot coding tasks (fix a bug, add a feature, refactor)
- CI/CD automation and scripting
- Structured data extraction with
--json-schema - Piped input processing (
cat file | claude -p "analyze this") - Any task where you don't need multi-turn conversation
Print mode skips ALL interactive dialogs — no workspace trust prompt, no permission confirmations. This makes it ideal for automation.
Mode 2: Interactive PTY via tmux — Multi-Turn Sessions
Interactive mode gives you a full conversational REPL where you can send follow-up prompts, use slash commands, and watch Claude work in real time. Requires tmux orchestration.
When to use interactive mode:
- Multi-turn iterative work (refactor → review → fix → test cycle)
- Tasks requiring human-in-the-loop decisions
- Exploratory coding sessions
- When you need to use Claude's slash commands (
/compact,/review,/model)
PTY Dialog Handling (CRITICAL for Interactive Mode)
Claude Code presents up to two confirmation dialogs on first launch. You MUST handle these via tmux send-keys:
Dialog 1: Workspace Trust (first visit to a directory)
Handling: tmux send-keys -t <session> Enter — default selection is correct.
Dialog 2: Bypass Permissions Warning (only with --dangerously-skip-permissions)
Handling: Must navigate DOWN first, then Enter:
Robust Dialog Handling Pattern
Note: After the first trust acceptance for a directory, the trust dialog won't appear again. Only the permissions dialog recurs each time you use --dangerously-skip-permissions.
CLI Subcommands
| Subcommand | Purpose | ||
|---|---|---|---|
claude | Start interactive REPL | ||
claude "query" | Start REPL with initial prompt | ||
claude -p "query" | Print mode (non-interactive, exits when done) | ||
| `cat file \ | claude -p "query"` | Pipe content as stdin context | |
claude -c | Continue the most recent conversation in this directory | ||
claude -r "id" | Resume a specific session by ID or name | ||
claude auth login | Sign in (add --console for API billing, --sso for Enterprise) | ||
claude auth status | Check login status (returns JSON; --text for human-readable) | ||
claude mcp add <name> -- <cmd> | Add an MCP server | ||
claude mcp list | List configured MCP servers | ||
claude mcp remove <name> | Remove an MCP server | ||
claude agents | List configured agents | ||
claude doctor | Run health checks on installation and auto-updater | ||
claude update / claude upgrade | Update Claude Code to latest version | ||
claude remote-control | Start server to control Claude from claude.ai or mobile app | ||
claude install [target] | Install native build (stable, latest, or specific version) | ||
claude setup-token | Set up long-lived auth token (requires subscription) | ||
claude plugin / claude plugins | Manage Claude Code plugins | ||
claude auto-mode | Inspect auto mode classifier configuration |
Print Mode Deep Dive
Structured JSON Output
Returns a JSON object with:
Key fields: session_id for resumption, num_turns for agentic loop count, total_cost_usd for spend tracking, subtype for success/error detection (success, error_max_turns, error_budget).
Streaming JSON Output
For real-time token streaming, use stream-json with --verbose:
Returns newline-delimited JSON events. Filter with jq for live text:
Stream events include system/api_retry with attempt, max_retries, and error fields (e.g., rate_limit, billing_error).
Bidirectional Streaming
For real-time input AND output streaming:
--replay-user-messages re-emits user messages on stdout for acknowledgment.
Piped Input
JSON Schema for Structured Extraction
Parse structured_output from the JSON result. Claude validates output against the schema before returning.
Session Continuation
Bare Mode for CI/Scripting
--bare skips hooks, plugins, MCP discovery, and CLAUDE.md loading. Fastest startup. Requires ANTHROPIC_API_KEY (skips OAuth).
To selectively load context in bare mode:
| To load | Flag | |
|---|---|---|
| System prompt additions | --append-system-prompt "text" or --append-system-prompt-file path | |
| Settings | --settings <file-or-json> | |
| MCP servers | --mcp-config <file-or-json> | |
| Custom agents | --agents '<json>' |
Fallback Model for Overload
Automatically falls back to the specified model when the default is overloaded (print mode only).
Complete CLI Flags Reference
Session & Environment
| Flag | Effect | |
|---|---|---|
-p, --print | Non-interactive one-shot mode (exits when done) | |
-c, --continue | Resume most recent conversation in current directory | |
-r, --resume <id> | Resume specific session by ID or name (interactive picker if no ID) | |
--fork-session | When resuming, create new session ID instead of reusing original | |
--session-id <uuid> | Use a specific UUID for the conversation | |
--no-session-persistence | Don't save session to disk (print mode only) | |
--add-dir <paths...> | Grant Claude access to additional working directories | |
-w, --worktree [name] | Run in an isolated git worktree at .claude/worktrees/<name> | |
--tmux | Create a tmux session for the worktree (requires --worktree) | |
--ide | Auto-connect to a valid IDE on startup | |
--chrome / --no-chrome | Enable/disable Chrome browser integration for web testing | |
--from-pr [number] | Resume session linked to a specific GitHub PR | |
--file <specs...> | File resources to download at startup (format: file_id:relative_path) |
Model & Performance
| Flag | Effect | |
|---|---|---|
--model <alias> | Model selection: sonnet, opus, haiku, or full name like claude-sonnet-4-6 | |
--effort <level> | Reasoning depth: low, medium, high, xhigh, max | |
--max-turns <n> | Limit agentic loops (print mode only; prevents runaway) | |
--max-budget-usd <n> | Cap API spend in dollars (print mode only) | |
--fallback-model <model> | Auto-fallback when default model is overloaded (print mode only) | |
--betas <betas...> | Beta headers to include in API requests (API key users only) |
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 89 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/autonomous-ai-agents/claude-code/SKILL.md
Popularity
- Repository stars
- 205
- Repository forks
- 43
- 7-day trend score
- 27
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 19 May 2026, 5 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/aivrar/portable-hermes-agent/claude-code)