service

Install and manage Claude Code as a launchd or systemd background service.

62|14|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/crisandrews/ClawCode --skill service-crisandrews
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: service
Source: https://github.com/crisandrews/ClawCode/tree/main/skills/service
Command: npx skills add https://github.com/crisandrews/ClawCode --skill service-crisandrews

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Claude Code stops running when the terminal closes, which breaks 24/7 features like the HTTP bridge, WebChat, webhooks, and scheduled crons. This Skill wraps Claude Code in the operating system's service manager so the agent keeps running continuously in the background. ## Core Features & Use Cases - Service Installation: Generates and installs a launchd plist on macOS or a systemd unit on Linux, preserving existing channel and session arguments. - Lifecycle Management: Check service status, view logs, and uninstall the service through simple commands. - Safety Guardrails: Requires explicit user confirmation before installing because the service runs with --dangerously-skip-permissions, and pre-checks ~/.claude/settings.json for skipDangerousModePermissionPrompt to prevent silent startup hangs. - Use Case: You want your agent's WebChat and scheduled crons available around the clock. Run the install action, confirm the permission warning, and the service starts automatically on boot. ## Quick Start Ask the agent to install the background service so Claude Code keeps running after the terminal closes, then confirm the permission warning when prompted.

Frequently Asked Questions about service

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run Claude Code as a background service?

Use the install action, which locates the claude binary, generates a launchd plist on macOS or a systemd unit on Linux, and registers it with the OS service manager. You must confirm a safety warning before installation proceeds.

How do I check the status of a launchd or systemd agent service?

Run the status action, which executes the service manager query commands returned by the service plan and summarizes the result as Active, Not loaded, or Unknown. The logs action tails the service log file for debugging.

Why does the background service hang at startup after install?

The service hangs when ~/.claude/settings.json lacks skipDangerousModePermissionPrompt set to true. Without it, a Bypass Permissions dialog appears at startup that no daemon can answer. The install flow pre-checks this setting and offers to add it.

Does the service work on both macOS and Linux?

Yes, it supports macOS through launchd plist files and Linux through systemd unit files. If the operating system is unsupported, the service plan returns an error and the installation stops.

What are the risks of running an agent with --dangerously-skip-permissions?

The flag pre-approves every tool call including Bash, Write, Edit, and network requests for the service's entire lifetime, and it cannot be undone per-request. It is required because a daemon cannot answer interactive approval prompts, so installation demands explicit user confirmation.