Ctx

ctx

Local context manager for Claude Code and Codex.

Keep exact conversation bindings, resume work cleanly, branch context without mixing streams, and optionally inspect saved workstreams in a local browser frontend.

Why ctx

- Exact transcript binding: each internal ctx session can bind to the exact Claude and/or Codex conversation it came from.
- No transcript drift: later pulls stay on that bound conversation instead of jumping to the newest chat on disk.
- Safe branching: start a new workstream from the current state of another one without sharing future transcript pulls or hijacking the source conversation.
- Indexed retrieval: saved workstreams, sessions, and entries are indexed for fast ctx search lookup.
- Curated loads: pin saved entries so they always load, exclude saved entries so they stay searchable but stop getting passed back to the model, or delete them entirely.
- Local-first: no API keys, no hosted service, plain SQLite plus local files.

Quick Install

Clone the repo and do the standard project-local setup:

This is the main development-friendly install path.

It does the following:

- creates ./.contextfun/context.db
- writes ./ctx.env
- installs a repo-backed ctx shim into ~/.contextfun/bin
- links local skills into ~/.claude/skills and ~/.codex/skills

Use this when:

- you want the repo checked out locally
- you want ctx to use a project-local DB by default
- you are developing or editing the repo itself

4-Step Demo

1. Clone and set it up:

2. Start a new workstream:

Claude Code:

Codex or your terminal:

3. Know what --pull means:

- ctx start feature-audit --pull creates the workstream and pulls the existing context from the current conversation into it.
- ctx start feature-audit creates the workstream starting from that point only. It…