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.6.tar.gz (81.3 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.6-py3-none-any.whl (54.5 kB view details)

Uploaded Python 3

File details

Details for the file ctxforge-1.4.6.tar.gz.

File metadata

  • Download URL: ctxforge-1.4.6.tar.gz
  • Upload date:
  • Size: 81.3 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.6.tar.gz
Algorithm Hash digest
SHA256 e9a948e1232201d428ef6a58c0b7517995f170353f8fb47fb2f006a4dbce67c5
MD5 45c6e0b44ffbf20be2299b526eb1e238
BLAKE2b-256 4afe675af34e13e80ff20fa619f1e1ccb521472f7752b9108168360839a7f778

See more details on using hashes here.

File details

Details for the file ctxforge-1.4.6-py3-none-any.whl.

File metadata

  • Download URL: ctxforge-1.4.6-py3-none-any.whl
  • Upload date:
  • Size: 54.5 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 9d6839c4ba166af598fc960ddca54f64f2516a03d76dfb862ff8a85d477d56dc
MD5 d372c5ec7f98d3d43e395f0edaba56fc
BLAKE2b-256 5a33c69bd3e1703f2661cc73f94f006c8b1201460ebf5b33be8b02d1bb3257c8

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