claude-code-agent

Orchestrate Claude Code as a background agent for local tasks.

6|1|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/cedricziel/assistant --skill claude-code-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-code-agent
Source: https://github.com/cedricziel/assistant/tree/main/skills/claude-code-agent
Command: npx skills add https://github.com/cedricziel/assistant --skill claude-code-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates agentic work on the local machine by orchestrating Claude Code to execute code, edit files, run shell commands, build projects, and analyze repositories without switching contexts.

Core Features & Use Cases

  • Background task execution with fire-and-forget async jobs via tmux.
  • Blocking mode for quick one-shot tasks and follow-ups in the same session.
  • Multi-step task handling: code edits, builds, repository analysis, and automation workflows.
  • Prompt-driven sessions with resume capability and safe, sandboxed tool use.

Quick Start

Start the Claude Code agent and provide a task prompt to begin a session.

Frequently Asked Questions about claude-code-agent

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

FAQPage Schema
How do I run Claude Code as a background agent for local shell automation?

You can run Claude Code as a background agent for local shell automation by orchestrating it in fire-and-forget async mode via tmux, allowing code execution and builds to proceed without switching contexts.

What is the difference between blocking and async modes for local task execution?

Local task execution uses blocking mode for quick one-shot tasks and follow-ups in the same session, while async mode handles fire-and-forget background jobs via tmux for longer multi-step workflows.

Can I resume a multi-step shell automation session after it stops?

Yes, you can resume multi-step shell automation sessions. The agent supports prompt-driven sessions with resume capability, allowing you to continue repository analysis and code editing workflows.

Does this approach require tmux to run local repository analysis tasks?

Tmux is required specifically for async background task execution. For quick, one-shot local repository analysis tasks, you can use blocking mode without relying on tmux sessions.

What's the best way to automate code editing and builds across multiple steps?

The best way to automate multi-step code editing and builds is using prompt-driven sessions that orchestrate Claude Code, handling everything from file edits to shell commands with safe, sandboxed tool use.