AI role-matrix context manager — define AI profiles and inject context into any AI CLI.
Project description
ctxforge
Simple context manager for AI CLI tools.
Define AI work profiles, select key files, and launch your AI CLI with project context injected automatically.
Install
pip install ctxforge
Requires Python >= 3.11 and at least one AI CLI (e.g. Claude Code, Codex).
Usage
ctxforge init # scan project, create first profile
ctxforge run # start AI CLI with context
Commands
| Command | Description |
|---|---|
ctxforge init |
Initialize project config and profile |
ctxforge run [PROFILE] |
Start AI CLI session with context |
ctxforge profile create NAME |
Create a new profile |
ctxforge profile list |
List all profiles |
ctxforge ctx profile |
Show profile configuration |
ctxforge ctx files |
List key files with size info |
ctxforge ctx update [--all] |
AI updates stale key files |
ctxforge ctx compress [--all] |
AI compresses verbose key files |
ctxforge tool add NAME |
Register an MCP tool (from registry, GitHub URL, or manually) |
ctxforge tool search KEYWORD |
Search the MCP registry |
ctxforge tool setup NAME |
Launch AI CLI to install/configure a tool |
ctxforge tool list |
List registered tools and status |
ctxforge tool check |
Check tool availability |
ctxforge tool disable NAME |
Disable a tool for a profile |
ctxforge tool enable NAME |
Re-enable a disabled tool |
ctxforge tool remove NAME |
Remove a tool from the project |
ctxforge clean |
Remove all ctxforge configuration |
Links
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ctxforge-1.4.5.tar.gz.
File metadata
- Download URL: ctxforge-1.4.5.tar.gz
- Upload date:
- Size: 77.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a4e20427393a7e2fd81e751232e8dd64af1fa90bf33bb985b52504b10ee6e562
|
|
| MD5 |
935d9700fc7659a229b07eec930ae936
|
|
| BLAKE2b-256 |
449604aa757928aa2c790dcc5d1662414c2c53da657a3ceb68aa1b19aca63bc9
|
File details
Details for the file ctxforge-1.4.5-py3-none-any.whl.
File metadata
- Download URL: ctxforge-1.4.5-py3-none-any.whl
- Upload date:
- Size: 51.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bb431a6afbdd56a979162483a0935b8502f0f562dfad42091dfeaef1a22b74a3
|
|
| MD5 |
152c3dde9018c18abb8f3cc145e73b96
|
|
| BLAKE2b-256 |
2aaebb9c40aa8fa2ca1d938264ce1c7647843c8eb6c8264b6065a9819003b21f
|