An open-source tool for AI-assisted coding

Keep your project notes.
Continue where you left off.

OpenWolf helps your coding assistant find the right files, keep useful notes and pick up saved work. You can review what it recorded in a local dashboard.

Set up OpenWolf View the source ↗

Version 2.5.3 · See the changes and test results

A simple example

Start a new session
with a useful next step.

Find the relevant code, save what is done and update the next step as work progresses. Your next session can use those notes and check the current files before continuing.

terminal1 / 3 · Find the code

The project index points to the relevant file and function.

Illustrative demo · output shortened

What it helps you do

Less searching. Clearer project history.

Find relevant files

OpenWolf builds a searchable file index with short descriptions. Your assistant can use it to find a function or choose which part of a large file to read.

Keep useful notes

Save the current task, decisions and known fixes in your project. Old session notes can be archived and restored. You can inspect the files yourself.

Reduce repeated information

Supported integrations can warn about repeated file reads and shorten large command results. The full command output is kept locally when it is shortened.

Understand recorded usage

The dashboard shows available token records, project activity and errors. Tokens are the units an AI model uses to process text. Price estimates are separate from your actual bill.

Getting started

Install it in your project.

You need Node.js 20 or later and a supported coding assistant. Run these commands from your project's folder. Choose the assistant you use during setup.

Read the setup guide →

Terminal

npm install -g openwolf
openwolf init
openwolf dashboard

Install OpenWolf, choose your assistant and open the dashboard.

Choose your assistant

Support depends on the integration.

Assistant	What to expect
Claude Code	Session context, file activity, command-output controls and available usage records.
Codex	Supported session and shell hooks, saved-task recovery and available usage records.
OpenCode	Plugin-based context, file activity and usage. Supports the OpenCode V2 plugin API.
Other adapters	Some provide project instructions only. They do not all support the same hooks or reporting.

Read the integration guide for the supported features and test limits.

Your project, on your machine

Files you can inspect.
Settings you can change.

OpenWolf stores project notes and local records in a .wolf folder. Its dashboard runs on your machine and requires a project access token.

OpenWolf does not make its own AI model calls. Your coding assistant still uses its configured provider. Optional update checks contact npm.

Missing usage data is shown as unavailable. Shorter command output does not prove a lower bill. Saved notes are evidence to review, not proof that a test passed.

Configuration · How it works · Updates and backups

New in 2.5.3

Repairs to everyday use.

More reliable background scanning and Windows command execution.
OpenCode V2 support, with checks for reads, edits and usage tracking.
Less repeated startup context and better handling of disabled projects.
Maintenance catch-up after sleep or restart, and safer project upgrades.
Clearer dashboard pages, with diagnostics kept separate from the overview.

Read the release record →

Built with community help

Thank you to our contributors.

These people contributed code, reported problems, tested fixes or helped shape the work. Original authorship and contribution roles are recorded in the project.

See the full credits and contribution records →

Keep your project notes.Continue where you left off.

Start a new sessionwith a useful next step.