Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ctxforge-1.4.5.tar.gz (77.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ctxforge-1.4.5-py3-none-any.whl (51.7 kB view details)

Uploaded Python 3

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

Hashes for ctxforge-1.4.5.tar.gz
Algorithm Hash digest
SHA256 a4e20427393a7e2fd81e751232e8dd64af1fa90bf33bb985b52504b10ee6e562
MD5 935d9700fc7659a229b07eec930ae936
BLAKE2b-256 449604aa757928aa2c790dcc5d1662414c2c53da657a3ceb68aa1b19aca63bc9

See more details on using hashes here.

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

Hashes for ctxforge-1.4.5-py3-none-any.whl
Algorithm Hash digest
SHA256 bb431a6afbdd56a979162483a0935b8502f0f562dfad42091dfeaef1a22b74a3
MD5 152c3dde9018c18abb8f3cc145e73b96
BLAKE2b-256 2aaebb9c40aa8fa2ca1d938264ce1c7647843c8eb6c8264b6065a9819003b21f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page