A repo that remembers what your AI forgot.
CTRL-FORGE is a durable folder your AI reads at the start of each session so work carries over across days, chats, and AI systems.
Public/privacy boundary: this repository is the public template/system upstream. Real personal work belongs only in a private copy. The canonical upstream must never contain personal projects, manuscripts, research, private prompts, or other private project payloads. See PUBLIC_BOUNDARY.md.
- Your projects live in a repo, not in a chat window that evaporates.
- A small agent — the Librarian — knows where things go and what's still open.
- Any AI picks up where the last one stopped by reading the durable project state.
forge/ ← the reusable system
mine/ ← your private work in your private copy; templates/examples only upstream
They stay separated so system updates do not overwrite project work.
- Click Use this template → make your copy Private.
- Clone your private copy.
- Make a project:
python tools/new_project.py "My First Project"Open mine/projects/example-project/ to see the public example structure.
If you publish a copy/fork or contribute back to this public upstream, remove all personal mine/ content first. The canonical upstream CI permits only the documented template/example allowlist under mine/. Private copies may track their real project work normally.
Run:
python tools/public_boundary_check.pybefore publishing an upstream-shaped copy.
The Librarian routes work, catches duplicates, checks readiness, points to specialists, and writes handoffs. More in forge/agents/librarian.md.
The normal setup is a private copy linked conceptually to this public template. See UPDATING.md. Nothing auto-updates.
- Folders are not encryption. Private means a private repository with appropriate access controls.
- Nothing private or final should go public without human review.
- CI reduces accidental publication risk but cannot undo data that was already copied, cloned, cached, or published elsewhere.
See CONTRIBUTING.md. Public contributions must contain no personal project data.
MIT licensed.