How frxfcrder/codekitctx works
CodeKitCtx turns a repository into structured context through scanning, filtering, optional symbol extraction, statistics and tree generation, then formatting and delivery. Users can initiate this workflow through the CLI, Python library, or FastAPI service. The graph reflects the sampled orchestration and the README’s documented formats, prompt wrapping, and API protections; server internals and some compiler modules were only partly sampled, so uncertain wiring is omitted.
Main entry points: context.py Compile orchestrator · cli.py CLI · server.py HTTP API · scanner.py Repository scanner
Components 20
Entry points
- CLI
codekitctx/cli.py - Python context API
codekitctx/core/context.py
Context pipeline
- Compile orchestrator
codekitctx/core/context.py - Repository scanner
codekitctx/core/scanner.py - File filters
codekitctx/core/filters.py
Analysis
- Symbol parser
codekitctx/parser/sitter.py - Statistics
codekitctx/core/stats.py - Directory tree
codekitctx/core/tree.py
Formatting and delivery
- Markdown renderer
codekitctx/compiler/markdown.py - JSON renderer
codekitctx/compiler/json_fmt.py - Prompt wrapper
codekitctx/compiler/prompt.py - File output
codekitctx/output/file.py - Clipboard output
codekitctx/output/clipboard.py
API service
- HTTP API
codekitctx/server.py - API safeguards
codekitctx/server.py
Other components
- CLI user
- Library user
- API client
- Repository files
- Terminal
Connections 19
- CLI user → CLI: runs
- CLI → Compile orchestrator: compiles via
- Library user → Python context API: calls
- Python context API → Compile orchestrator: compiles via
- API client → HTTP API: requests context
- HTTP API → API safeguards: checks request
- HTTP API → Compile orchestrator: compiles via
- Compile orchestrator → Repository scanner: scans
- Repository scanner → Repository files: reads files
- Compile orchestrator → File filters: filters
- Compile orchestrator → Symbol parser: extracts symbols
- Compile orchestrator → Statistics: calculates stats
- Compile orchestrator → Directory tree: builds tree
- Compile orchestrator → Markdown renderer: renders Markdown
- Compile orchestrator → JSON renderer: renders JSON
- Compile orchestrator → Prompt wrapper: wraps output
- CLI → File output: saves result
- CLI → Clipboard output: copies result
- CLI → Terminal: writes result