Autonomous Agent Nightshift

A Claude Code skill and bash harness for running AI agents overnight on your codebase.
Write a todo file with Implementation+Validation pairs. Launch. Wake up to validated code — or a PR with review feedback already addressed.

_{Distilled from production runs on multiple SaaS codebases (Next.js, Bun, Supabase, Stripe). Adapters documented for Python, Go, Rust.}

How it works

Feature plan
_{todo file with checkboxes}

You write the WHAT.

Runner script
_{bash harness}

Orchestrates the loop.

Codebase context
_{embedded heredoc}

Where things live.

Per-task pipeline:

Phase 1: Implement   Claude writes code + tests
Phase 2: Validate    prettier . tsc . eslint . test runner
  -> Fix loop        up to MAX_FIX_ATTEMPTS (default 7)
Phase 3: Chrome      optional live browser test via Claude-in-Chrome MCP
  -> Fix loop        up to MAX_CHROME_FIX_ATTEMPTS (default 3)
Phase 4: Mark done   checkbox [x] in todo file

Failed tasks get [x] -- NEEDS MANUAL REVIEW and the loop moves on. You triage in the morning.

Install

Pick whichever channel matches your tooling. Full walkthrough: USAGE.md.

Channel	Command
npm _recommended	`npm install -g autonomous-agent-nightshift # or one-shot: npx autonomous-agent-nightshift init my-feature`
Homebrew	`brew install noluyorAbi/tap/nightshift # or directly from repo (no tap yet): brew install --HEAD https://raw.githubusercontent.com/noluyorAbi/autonomous-agent-nightshift/main/Formula/nightshift.rb`
curl one-liner _{installs as Claude Code skill}	`curl -fsSL https://raw.githubusercontent.com/noluyorAbi/autonomous-agent-nightshift/main/bin/install.sh \| bash`
Claude Code plugin	`/plugin marketplace add noluyorAbi/autonomous-agent-nightshift /plugin install autonomous-agent-nightshift`
GitHub Release tarball	`curl -fsSL https://github.com/noluyorAbi/autonomous-agent-nightshift/releases/latest/download/autonomous-agent-nightshift.tar.gz \| tar xz`
Git clone _{full repo}	`git clone https://github.com/noluyorAbi/autonomous-agent-nightshift`

[!NOTE] For the plugin path, /plugin marketplace add only registers the source. You must run /plugin install autonomous-agent-nightshift, then fully quit and relaunch Claude Code. The same restart applies if you install as a skill (curl one-liner or git clone into ~/.claude/skills/).

What each channel gives you

autonomous-agent-nightshift

Popularity

What's Inside

README