cli-reference
Claude Code CLI commands, flags, headless mode, and automation patterns
Install / Use
npx skills add parcadei/Continuous-Claude-v3 --skill cli-referenceInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Tags
Our assessment of cli-reference
cli-reference scores 86/100 on our quality scale, 1787th of 2,790 Automation skills we index.
Its SKILL.md is 7.3 KB long, well organised into 27 sections with 9 code examples: a thorough specification that gives an agent plenty to work with.
With 3,943 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 10 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- Our last check on 2026-11-03 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 94/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
ReviewOur scan of the whole file found 3 patterns worth reviewing before you install cli-reference. An AI review judged it risky: The skill file documents and promotes `--dangerously-skip-permissions` as a required part of headless agent patterns (e.g., 'Headless Agent Pattern (CRITICAL)' and CI/CD examples), which disables permission prompts.
- mediumDisables the agent's permission promptsline 51
| `--dangerously-skip-permissions` | Skip permission prompts | `claude -p --dangerously-skip-permissions` | - mediumDisables the agent's permission promptsline 51
| `--dangerously-skip-permissions` | Skip permission prompts | `claude -p --dangerously-skip-permissions` | - mediumDisables the agent's permission promptsline 51
| `--dangerously-skip-permissions` | Skip permission prompts | `claude -p --dangerously-skip-permissions` |
AI review: risky
- The skill file documents and promotes `--dangerously-skip-permissions` as a required part of headless agent patterns (e.g., 'Headless Agent Pattern (CRITICAL)' and CI/CD examples), which disables permission prompts.
- As a skill/rules file, these examples are instructions/patterns the agent may follow, directly weakening safeguards by auto-approving actions.
- The content is otherwise a legitimate CLI reference with no evidence of data theft, backdoors, or hidden behavior.
AI review by kimi-k2.7-code on 2026-10-01. Automated pattern scan on 2026-10-01. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
cli-reference compared with similar skills
All 4 of these similar skills score higher than cli-reference; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| cli-reference (this skill)by parcadei | 86 | 3.9k | 10mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.7k | 7d ago | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
Frequently asked questions
- How do I install cli-reference?
- Run
npx skills add parcadei/Continuous-Claude-v3 --skill cli-reference. The install tabs above show the steps for each supported agent. - Which AI agents does cli-reference work with?
- It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is cli-reference safe to use?
- Our scan of the whole file found 3 patterns worth reviewing before you install cli-reference. An AI review judged it risky: The skill file documents and promotes
--dangerously-skip-permissionsas a required part of headless agent patterns (e.g., 'Headless Agent Pattern (CRITICAL)' and CI/CD examples), which disables permission prompts. It is MIT-licensed and scores 94/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand. - Is cli-reference still maintained?
- The repository was last updated about 10 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubname: cli-reference description: Claude Code CLI commands, flags, headless mode, and automation patterns allowed-tools: [Read]
CLI Reference
Complete reference for Claude Code command-line interface.
When to Use
- "What CLI flags are available?"
- "How do I use headless mode?"
- "Claude in automation/CI/CD"
- "Output format options"
- "System prompt via CLI"
- "How do I spawn agents properly?"
Core Commands
| Command | Description | Example |
|---------|-------------|---------|
| claude | Start interactive REPL | claude |
| claude "query" | REPL with initial prompt | claude "explain this project" |
| claude -p "query" | Headless mode (SDK) | claude -p "explain function" |
| cat file \| claude -p | Process piped content | cat logs.txt \| claude -p "explain" |
| claude -c | Continue most recent | claude -c |
| claude -c -p "query" | Continue via SDK | claude -c -p "check types" |
| claude -r "id" "query" | Resume session | claude -r "auth" "finish PR" |
| claude update | Update version | claude update |
| claude mcp | Configure MCP servers | See MCP docs |
Session Control
| Flag | Description | Example |
|------|-------------|---------|
| --continue, -c | Load most recent conversation | claude --continue |
| --resume, -r | Resume session by ID/name | claude --resume auth-refactor |
| --session-id | Use specific UUID | claude --session-id "550e8400-..." |
| --fork-session | Create new session on resume | claude --resume abc --fork-session |
Headless Mode (Critical for Agents)
| Flag | Description | Example |
|------|-------------|---------|
| --print, -p | Non-interactive, exit after | claude -p "query" |
| --output-format | text, json, stream-json | claude -p --output-format json |
| --max-turns | Limit agentic turns | claude -p --max-turns 100 "query" |
| --verbose | Full turn-by-turn output | claude --verbose |
| --dangerously-skip-permissions | Skip permission prompts | claude -p --dangerously-skip-permissions |
| --include-partial-messages | Include streaming events | claude -p --output-format stream-json --include-partial-messages |
| --input-format | Input format (text/stream-json) | claude -p --input-format stream-json |
Tool Control
| Flag | Description | Example |
|------|-------------|---------|
| --allowedTools | Auto-approve these tools | "Bash(git log:*)" "Read" |
| --disallowedTools | Block these tools | "Bash(rm:*)" "Edit" |
| --tools | Only allow these tools | --tools "Bash,Edit,Read" |
Subagent Definition (--agents flag)
Define custom subagents inline via JSON:
claude --agents '{
"code-reviewer": {
"description": "Expert code reviewer. Use proactively after code changes.",
"prompt": "You are a senior code reviewer. Focus on code quality and security.",
"tools": ["Read", "Grep", "Glob", "Bash"],
"model": "sonnet"
},
"debugger": {
"description": "Debugging specialist for errors and test failures.",
"prompt": "You are an expert debugger. Analyze errors and provide fixes."
}
}'
Agent Fields
| Field | Required | Description |
|-------|----------|-------------|
| description | Yes | When to invoke this agent |
| prompt | Yes | System prompt for behavior |
| tools | No | Allowed tools (inherits all if omitted) |
| model | No | sonnet, haiku, or claude-opus-4-5-20251101 |
Key Insight
When Lead uses Task tool, it auto-spawns from these definitions. No manual spawn needed.
System Prompt Customization
| Flag | Behavior | Modes |
|------|----------|-------|
| --system-prompt | Replace entire prompt | Interactive + Print |
| --system-prompt-file | Replace from file | Print only |
| --append-system-prompt | Append to default (recommended) | Interactive + Print |
Use --append-system-prompt for most cases - preserves Claude Code capabilities.
Model Selection
| Flag | Description | Example |
|------|-------------|---------|
| --model | Set model for session | --model claude-sonnet-4-5 |
| --fallback-model | Fallback if default overloaded | --fallback-model sonnet |
Aliases: sonnet, opus, haiku
MCP Configuration
| Flag | Description | Example |
|------|-------------|---------|
| --mcp-config | Load MCP servers from JSON | --mcp-config ./mcp.json |
| --strict-mcp-config | Only use these MCP servers | --strict-mcp-config --mcp-config ./mcp.json |
Advanced Flags
| Flag | Description | Example |
|------|-------------|---------|
| --add-dir | Add working directories | --add-dir ../apps ../lib |
| --agent | Specify agent for session | --agent my-custom-agent |
| --permission-mode | Start in permission mode | --permission-mode plan |
| --permission-prompt-tool | MCP tool for permissions | --permission-prompt-tool mcp_auth |
| --plugin-dir | Load plugins from directory | --plugin-dir ./my-plugins |
| --settings | Load settings from file/JSON | --settings ./settings.json |
| --setting-sources | Which settings to load | --setting-sources user,project |
| --betas | Beta API headers | --betas interleaved-thinking |
| --debug | Enable debug mode | --debug "api,hooks" |
| --ide | Auto-connect to IDE | --ide |
| --chrome | Enable Chrome integration | --chrome |
| --no-chrome | Disable Chrome for session | --no-chrome |
| --enable-lsp-logging | Verbose LSP debugging | --enable-lsp-logging |
| --version, -v | Output version | claude -v |
Output Formats
JSON (for parsing)
claude -p "query" --output-format json
# {"result": "...", "session_id": "...", "usage": {...}}
Streaming (for real-time monitoring)
claude -p "query" --output-format stream-json
# Newline-delimited JSON events
Structured Output (schema validation)
claude -p "Extract data" \
--output-format json \
--json-schema '{"type":"object","properties":{...}}'
Headless Agent Pattern (CRITICAL)
Proper headless agent spawn:
claude -p "$TASK_PROMPT" \
--session-id "$UUID" \
--dangerously-skip-permissions \
--max-turns 100 \
--output-format stream-json \
--agents '{...}' \
--append-system-prompt "Context: ..."
Missing any of these causes hangs:
--session-id- Track the session--dangerously-skip-permissions- Headless requires this--max-turns- Prevents infinite loops
Common Patterns
CI/CD Automation
claude -p "Run tests and fix failures" \
--dangerously-skip-permissions \
--max-turns 50 \
--output-format json | jq '.result'
Piped Input
cat error.log | claude -p "Find root cause"
gh pr diff | claude -p "Review for security"
Multi-turn Session
id=$(claude -p "Start task" --output-format json | jq -r '.session_id')
claude -p "Continue" --resume "$id"
Stream Monitoring
claude -p "Long task" \
--output-format stream-json \
--include-partial-messages | while read -r line; do
echo "$line" | jq '.type'
done
Keyboard Shortcuts (Interactive)
| Shortcut | Action |
|----------|--------|
| Ctrl+C | Cancel current |
| Ctrl+D | Exit |
| Ctrl+R | Reverse search history |
| Esc Esc | Rewind changes |
| Shift+Tab | Toggle permission mode |
Quick Commands
| Prefix | Action |
|--------|--------|
| / | Slash command |
| ! | Bash mode |
| # | Add to memory |
| @ | File mention |
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Claude-Code-Game-Studios
39.7kTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Scrapling
103.6k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
