SkillAgentSearch skills...

cli-reference

Claude Code CLI commands, flags, headless mode, and automation patterns

Install / Use

npx skills add parcadei/Continuous-Claude-v3 --skill cli-reference

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

86/100

Category

Automation

Supported Platforms

Claude Code

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.

Substance
29/30
Structure
20/20
Description
12/15
Adoption
15/20
Freshness
11/15

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

Review

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-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.

SkillScoreStarsUpdatedFormat
cli-reference (this skill)by parcadei863.9k10mo agoSKILL.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10039.7k7d agoCLAUDE.md
Scraplingby D4Vinci100103.6k2d agoMCP 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-permissions as 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.

name: 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

View on GitHub
GitHub Stars3.9k
CategoryAutomation
Updated9mo ago
Forks303

Languages

Python

Trust signals

94/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 low