About autonomous
autonomous is a Claude Code skill for switching a project to autonomous mode. It uses a shared mode controller and directs agents to the project's operating-mode rules.
Key features
- 01Set mode to autonomous
- 02Share mode state across agents and hooks
- 03Use operating-mode rules
Use cases
- 01Restore autonomous mode in Claude Code
- 02Let hooks read the current mode
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ camacho/ ai-skills --skill autonomousAfter installing, type/autonomousin Claude Code to confirm it loaded.
Bundled filesscripts/mode.shscripts/set-mode.sh
Details
From the project READMEReturn to Autonomous Mode
Claude Code enforcement only — Codex and Cursor default to autonomous unless a future adapter uses this shared controller. Shared mode controller:
.agents/skills/autonomous/scripts/.
Shared Controller
Mode is a setting with explicit values: autonomous and copilot.
For now, this skill owns the shared mode controller because autonomous is the default and safe fallback value. /copilot is an alias that sets mode=copilot; it should not own separate mode logic.
.agents/skills/autonomous/scripts/mode.shis the sourceable mode facade for all agents and hooks..agents/skills/autonomous/scripts/set-mode.shsetsmode=autonomousormode=copilot.scripts/lib/session-state.shremains project infrastructure because status, detection, bootstrap, and hook code all use it.
Activate
REPO_ROOT="$(git rev-parse --show-toplevel)"
"$REPO_ROOT/.agents/skills/autonomous/scripts/set-mode.sh" autonomous
If the script does not exist, tell the user: "This project doesn't have mode switching scripts. You are already in autonomous mode by default."
Confirmation
After activation, print:
Mode: autonomous
Worktree enforcement active. Full workflow pipeline.
Behavior
Follow autonomous mode rules in .claude/rules/operating-mode.md.
Agents and hooks that need live mode state should source the shared helper or call scripts/session-state get mode; do not read raw mode-state files directly.