Agent skill · software engineering · aiskillstore
claude-code-headless
Run Claude Code programmatically without interactive UI. Triggers on: headless, CLI automation, --print, output-format, stream-json, CI/CD, scripting.
Why this skill is useful
Adds executable scripts and specific CLI commands for headless operation of Claude Code that aren't in public documentation.
What it needs
Requires jq installed locally. About 2k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Claude Code Headless Mode Run Claude Code from scripts without interactive UI. Quick Start Essential CLI Options Flag Description ------ ------------- -p, --print Non-interactive (headless) mode --output-format text, json, stream-json -r, --resume Resume by session ID -c, --continue Continue most recent session --allowedTools Comma-separated allowed tools --disallowedTools Comma-separated denied tools --mcp-config Path to MCP server config JSON --verbose Enable verbose logging --append-system-prompt Add to system prompt Permission Modes Mode Flag Effect ------ ------ -------- Default (none) Prompt for permissions Accept edits --permission-mode acceptEdits Auto-accept file changes Bypass --permission-mode bypassPermissions Skip all prompts Output Formats Text (default) JSON Stream-JSON Common Patterns Script with tool restrictions CI/CD integration Multi-turn automation Error Handling Official Documentation https://code.claude.com/docs/en/headless - Headless mode reference https://code.claude.com/docs/en/settings - Settings and permissions Additional Resources ./references/cli-options.md - Complete CLI flag reference ./references/output-formats.md - Output format schemas ./references/integration-patterns.md - CI/CD and scripting examples --- See Also: claude-code-hooks for automation events, claude-code-debug for troubleshooting
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/claude-code-headless