Fractary Codex CLI

Command-line interface for Fractary Codex knowledge management system.

Installation

``bash
npm install -g @fractary/codex-cli
`

Quick Start

`bash


Initialize configuration

fractary-codex configure

Fetch a document

fractary-codex document-fetch codex://myorg/myproject/README.md

Check cache status

fractary-codex cache-stats

Run health check

fractary-codex cache-health
`

Commands Overview

| Command | Description |
|---------|-------------|
| configure | Initialize configuration |
| document-fetch | Fetch documents by codex:// URI |
| cache-list | List cached documents |
| cache-clear | Clear cache entries |
| cache-stats | Show cache statistics |
| cache-health | Run diagnostics |
| sync | Sync project with codex repository |

Documentation

Full documentation: docs/cli/

- Commands Reference
- Integration Patterns
- Troubleshooting
- Configuration Guide

Configuration

Uses .fractary/config.yaml:

`yaml
organization: myorg
cacheDir: .fractary/codex/cache

storage:
- type: github
token: ${GITHUB_TOKEN}
`

Environment Variables

| Variable | Description |
|----------|-------------|
| GITHUB_TOKEN | GitHub access token |
| CODEX_CACHE_DIR | Override cache directory |
| CODEX_ORG | Override organization |

Development

`bash


Build

npm run build

Test

npm test

Type check

npm run typecheck

Link for local testing

npm link
``

License

MIT

See Also

- SDK Package - Core JavaScript SDK
- MCP Server - AI agent integration
- Documentation - Full documentation