NotFair is a local, on-device agent system for defining goals and running a measured improvement loop against them, using Claude Code or Codex as the harness. It stores data locally and provides a UI to monitor progress and actions.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
NotFair provides goal-driven marketing agents that operate on your machine, attaching to your existing Claude Code or Codex login, and using a local SQLite data store. The system lets you state an ambition, set a measurable target, and run a loop that measures, predicts, and acts within a defined cadence. It emphasizes local data storage (no hosted runtime or API keys) and per-goal agent workflows.
How it works
- Each ambition creates a dedicated agent that defines a measurable metric and a baseline, then proposes a target and cadence. The loop performs checks, logs predictions, and records diary entries for each action.
- The loop operates on your cadence and is designed to run continuously, with a spend envelope and observation window governing actions. The agent can perform at most one new move per cycle.
- Data sources can be connected via MCP endpoints or run locally via a local source using stdout; OAuth connections to data providers are configured through the app.
Getting started
Install options include running via npx or installing globally:
npx notfair@latest doctor # preflight: Node, harnesses, data dir, port
npx notfair@latest # launch the UI at http://127.0.0.1:3327
Or:
npm install -g notfair
notfair
From source, clone the repo and install with pnpm, then run the dev server:
git clone https://github.com/nowork-studio/NotFair.git
cd NotFair/notfair
pnpm install
pnpm dev # dev server with hot reload at http://127.0.0.1:3326
Recent releases
- RELEASES (latest 0): - none
Traction
- Stars: 3316
- Forks: 409
- Open issues: 6
Behind the repo
Not included in the provided material.
Caveats
- License: MIT
- Created: 2026-03-27
- Last push: 2026-07-31
- Data resides locally (e.g.,
~/.notfair/db.sqliteand~/.notfair/agents/directories); OAuth tokens stored in SQLite database (not encrypted at application layer per docs). - Prerequisites include Apple Silicon Mac, Node 20+, and an authenticated harness (Codex CLI or Claude Code).