Skip to content
Fractary Developers

Fractary CLI

Fractary CLI

Section titled “Fractary CLI”

Unified Command-Line Interface for All Fractary Tools

The Fractary CLI is the central interface that brings together all Fractary tools through a single, consistent command-line interface. No more installing separate CLIs for each tool—just install @fractary/cli and access everything.

Installation

Section titled “Installation”
Terminal window
npm install -g @fractary/cli

Fractary Tools

Section titled “Fractary Tools”

The CLI provides access to all Fractary tools:

  • 🎯 Faber - Universal AI agent orchestration (write-once, deploy-everywhere)
  • 📚 Codex - Centralized knowledge management and distribution
  • ⚒️ Forge - Asset management and project scaffolding
  • ⎈ Helm - Deployment and orchestration (coming soon)

Command Pattern

Section titled “Command Pattern”

All Fractary tools use a consistent command pattern:

Terminal window
fractary <tool> <command> [options]

This makes it easy to learn and use all tools once you understand the pattern.

Quick Examples

Section titled “Quick Examples”

Faber

Section titled “Faber”
Terminal window
# Initialize a Faber project
fractary faber init


# Create an AI agent role
fractary faber create role issue-manager --platforms github-issues,linear


# Validate the agent
fractary faber validate role issue-manager


# Build for Claude Code
fractary faber build claude role issue-manager


# List all concepts
fractary faber list

Codex

Section titled “Codex”
Terminal window
# Initialize Codex in a repository
fractary codex init --org your-org


# Validate documentation metadata
fractary codex validate docs/


# Check where a file will sync
fractary codex route docs/api-guide.md


# View configuration
fractary codex config show

Forge

Section titled “Forge”
Terminal window
# List available assets
fractary forge list


# Create a new project from a starter
fractary forge create my-blog --starter fractary/forge-starter-www-astro-blog


# Install a bundle
fractary forge install fractary/forge-bundle-team-core


# Check project status
fractary forge status


# Update bundles
fractary forge update team-core

Key Benefits

Section titled “Key Benefits”

Single Installation

Section titled “Single Installation”

Install one CLI for all Fractary tools instead of managing multiple packages.

Consistent Interface

Section titled “Consistent Interface”

All tools follow the same command pattern, making them easy to learn and use.

No Naming Conflicts

Section titled “No Naming Conflicts”

The main command is just fractary - no conflicts with existing tools.

Lazy Loading

Section titled “Lazy Loading”

Commands are loaded on-demand for better performance.

Unified Updates

Section titled “Unified Updates”

Update all tools together with a single npm update -g @fractary/cli.

Shared Utilities

Section titled “Shared Utilities”

Common functionality shared across all tools reduces code duplication.

Tool-Specific Documentation

Section titled “Tool-Specific Documentation”

For detailed documentation on each tool:

Use Cases

Section titled “Use Cases”

For Developers

Section titled “For Developers”
  • Rapid AI agent prototyping
  • Framework experimentation
  • Platform flexibility
  • Unified tooling experience

For Organizations

Section titled “For Organizations”
  • Inject company standards without forking
  • Consistent agents across teams
  • Environment-specific configurations
  • Centralized tooling management

For Open Source

Section titled “For Open Source”
  • Distribute reusable agent definitions
  • Community contributions
  • Multi-framework support

Current Status

Section titled “Current Status”

Version: 1.0.0+ Status: Production Ready License: MIT

Complete Features

Section titled “Complete Features”

Faber:

  • Core concept system (Roles)
  • Context system (7 categories)
  • Overlay system
  • Configuration management
  • Claude Code binding
  • Full CLI commands

Codex:

  • SDK integration (@fractary/codex)
  • Metadata parsing and validation
  • Routing analysis
  • Configuration management

Forge:

  • SDK integration (@fractary/forge)
  • GitHub-based asset distribution
  • Catalog-based discovery
  • Project scaffolding
  • Bundle management

In Progress

Section titled “In Progress”
  • Additional Faber concept loaders (Tools, Teams, Workflows, Evals)
  • LangGraph and CrewAI bindings
  • Codex GitHub Actions integration
  • Helm tool integration

Development

Section titled “Development”

Want to contribute? Here’s how to get started:

Terminal window
# Clone the repository
git clone https://github.com/fractary/cli.git
cd cli


# Install dependencies
npm install


# Build the project
npm run build


# Run tests
npm test


# Link for local development
npm link


# Test the CLI
fractary --help
Section titled “Related Packages”

The CLI depends on core SDK packages:

Support

Section titled “Support”