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.10 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.8.tar.gz (94.9 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.8-py3-none-any.whl (64.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ctxforge-1.4.8.tar.gz
  • Upload date:
  • Size: 94.9 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.8.tar.gz
Algorithm Hash digest
SHA256 826c37ef6b676da2fb296624152d7af445f12ddd968d5bf2ce9e0a87226c06be
MD5 70facc4e06f8bb5849abf942fe13e4a3
BLAKE2b-256 01bcff6e029f27ad42859d17e76fa07204c3f640de7cd160f0f874c5592aab22

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ctxforge-1.4.8-py3-none-any.whl
  • Upload date:
  • Size: 64.8 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.8-py3-none-any.whl
Algorithm Hash digest
SHA256 54fc4ac7ede786b788871e00fb3ac884a9ac36dc749976b236e814e7bb0b5236
MD5 45accc3e06fde0d6d2fa6c4a1ea1859e
BLAKE2b-256 ed48705bba116151b6ab50a1dd8016b760d52b97535cab0c7887f969b05a438f

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