Skip to content

jeffwhitlock/operator-mode

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Operator Mode

Operator Mode gives Claude Code a lightweight execution memory layer.

It creates a single file — PROJECT_STATUS.md — inside a repo and teaches Claude to use it as persistent working memory so work resumes cleanly after context resets, without adding project-management overhead.


Why Operator Mode?

Claude is powerful, but long-running work can lose continuity as context fills.

Operator Mode solves that by:

  • Maintaining a single high-signal status file
  • Preserving intent, progress, and next actions across sessions
  • Avoiding heavy frameworks, tickets, or scaffolding

It's not project management. It's continuity.


Install

Clone this repository and run the installer:

git clone https://github.com/jeffwhitlock/operator-mode.git
cd operator-mode
chmod +x install.sh
./install.sh

Restart Claude Code if it is already running.


Usage

Inside any repository, run:

/operator-new

This initializes Operator Mode for that repo.


What It Creates

A single file at the repo root:

PROJECT_STATUS.md

Claude maintains this file as working memory throughout the session.


Uninstall

cd operator-mode
./uninstall.sh

This removes the installed skill from ~/.claude/skills/.

(Project files are never modified or removed.)


Philosophy

Operator Mode is designed to be:

  • Minimal
  • Human-readable
  • Repo-local
  • Easy to remove
  • Invisible once initialized

No databases. No services. No lock-in. Just a smarter way for Claude to stay oriented while you work.


License

MIT

About

A lightweight working-memory layer for Claude Code that maintains project continuity across all kinds of work.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages