Metadata-Version: 2.4
Name: ctxforge
Version: 1.4.10
Summary: AI role-matrix context manager — define AI profiles and inject context into any AI CLI.
Project-URL: Homepage, https://github.com/lijihangmk2/ContextForge
Project-URL: Repository, https://github.com/lijihangmk2/ContextForge
Author: lijihangmk2
License-Expression: MIT
Keywords: ai,cli,context,developer-tools,llm
Requires-Python: >=3.10
Requires-Dist: jinja2>=3.1
Requires-Dist: pydantic>=2.0
Requires-Dist: questionary>=2.1
Requires-Dist: rich>=13.0
Requires-Dist: setproctitle>=1.3
Requires-Dist: tomli-w>=1.0
Requires-Dist: tomli>=2.0; python_version < '3.11'
Requires-Dist: typer>=0.15.0
Provides-Extra: all-llm
Requires-Dist: anthropic>=0.40; extra == 'all-llm'
Requires-Dist: google-generativeai>=0.8; extra == 'all-llm'
Requires-Dist: openai>=1.0; extra == 'all-llm'
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.40; extra == 'anthropic'
Provides-Extra: dev
Requires-Dist: mypy>=1.13; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Provides-Extra: google
Requires-Dist: google-generativeai>=0.8; extra == 'google'
Provides-Extra: openai
Requires-Dist: openai>=1.0; extra == 'openai'
Description-Content-Type: text/markdown

# 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

```bash
pip install ctxforge
```

Requires Python >= 3.10 and at least one AI CLI (e.g. Claude Code, Codex).

## Usage

```bash
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 cred …` | Manage system-level Claude/Codex credentials |
| `ctxforge clean` | Remove all ctxforge configuration |

## Links

- [GitHub](https://github.com/lijihangmk2/ContextForge)
- [Documentation](https://github.com/lijihangmk2/ContextForge#readme)

## License

MIT
