claude-headless
CommunityAutomate Claude Code tasks in CI/CD without a GUI.
Software Engineering#automation#CI/CD#Claude Code#DevOps#GitHub Actions#JSON#scripting#headless#server mode
Authornera0875
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Integrating Claude Code into automated workflows (CI/CD, scheduled tasks) requires execution without a graphical interface. This skill provides a comprehensive guide to Claude Code's headless mode, enabling seamless automation.
Core Features & Use Cases
- Execution Modes: Explains Stdin/Stdout (text), File-Based (JSON), and Server Mode (long-running daemon) for headless operation.
- CLI Flags & Options: Details various flags for model selection, timeouts, input/output formats, and context.
- Automation Patterns: Provides examples for CI/CD pipelines (GitHub Actions), scheduled tasks (Cron), and webhook integrations.
- Configuration & Error Handling: Guides on using a
.claude-headlessconfig file, environment variables, and handling errors/timeouts. - Use Case: Integrate Claude Code into a GitHub Actions CI/CD pipeline using the Stdin/Stdout mode to automatically scan backend Python files for quality issues after every push, ensuring continuous code quality checks without manual intervention.
Quick Start
Use the claude-headless skill to understand how to run Claude Code in Stdin/Stdout mode for basic automation.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: claude-headless Download link: https://github.com/nera0875/AGI/archive/main.zip#claude-headless Please download this .zip file, extract it, and install it in the .claude/skills/ directory.