whatisgithub

What is claude-vigil?

jzb1006/claude-vigil — explained in plain English

Analysis updated 2026-05-18

18PythonAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A Python task queue manager that runs Claude Code on a list of tasks unattended, giving each one an isolated git branch to review, with dependency support and quota-aware pausing.

Mindmap

mindmap
  root((claude-vigil))
    What it does
      Queues Claude Code tasks
      Isolates each task in a worktree
      Pauses on rate limits
    Tech stack
      Python
      Claude Code CLI
      Git
    Use cases
      Run many coding tasks unattended
      Chain dependent tasks
      Restrict file write scope
    Audience
      Developers
      AI coding tool users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Queue a list of coding tasks and let Claude Code work through them unattended

USE CASE 2

Review each finished task on its own git branch before merging

USE CASE 3

Chain tasks so one only starts after another has committed its work

USE CASE 4

Restrict which files a task's Claude session is allowed to modify

What is it built with?

PythonClaude Code CLIGit

How does it compare?

jzb1006/claude-vigilandyuneducated/resolve-aicarriex6/cvpr2026_similarity_as_evidence
Stars181818
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Python 3.11+, the claude CLI authenticated with an Anthropic account, and git 2.30+, still pre-release at v0.1.

License is not stated in the provided text.

So what is it?

Vigil is a task queue manager for Claude Code, Anthropic's AI coding assistant. The idea is simple: you write a list of tasks, start Vigil, walk away, and come back to a set of branches in your git repository where each task has been attempted. The tagline is "run Claude Code while you don't." Each task gets its own isolated git worktree on a dedicated branch named after the task. The source repository is never touched directly. When a task finishes, Vigil commits whatever Claude left in the worktree using a conventional commit message inferred from the changed files and prompt text, then pushes the branch to origin. You review the branch and decide whether to merge, discard, or ignore it. Vigil never merges on your behalf. Task dependencies are supported. If task B depends on task A, Vigil will not start B until A has committed its branch, and B will fork from A's branch tip so the work carries forward. Quota handling is reactive. Vigil watches Claude Code's rate-limit signals directly. When Anthropic's servers signal a limit, Vigil pauses the task and schedules a wake-up based on the exact reset time the server provides. On wake-up it resumes the same Claude session using the session ID, so the agent can continue from where it left off without re-reading the entire codebase. Scope hooks let you restrict which files each task is allowed to write. If Claude tries to modify a file outside the specified pattern list, Vigil intercepts the request and returns a structured refusal rather than letting the agent silently write wherever it wants. After a task runs, Vigil asks the same Claude session for a brief structured summary covering decisions made, assumptions, items skipped, and potential merge risks. Because the same session context is still warm, this costs very little. Installation requires Python 3.11 or later, the claude CLI authenticated with an Anthropic account, and git 2.30 or later. The project was at v0.1 pre-release when last checked, with APIs and config formats subject to change before v1.0.

Copy-paste prompts

Prompt 1
Help me write a task list file that Vigil can run against my repository
Prompt 2
Explain how Vigil handles Claude Code rate limits and resumes a paused task
Prompt 3
Show me how to set up a scope hook that limits which files a task can write
Prompt 4
Walk me through configuring a task that depends on another task finishing first

Frequently asked questions

What is claude-vigil?

A Python task queue manager that runs Claude Code on a list of tasks unattended, giving each one an isolated git branch to review, with dependency support and quota-aware pausing.

What language is claude-vigil written in?

Mainly Python. The stack also includes Python, Claude Code CLI, Git.

What license does claude-vigil use?

License is not stated in the provided text.

How hard is claude-vigil to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is claude-vigil for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.