CLI Commands

Complete reference for all IronCode command-line interface commands

Global Options

These options work with any command:

--print-logs

Print debug logs to console

--log-level <level>

Set log level (debug, info, warn, error)

--max-memory <mb>

Memory limit in MB (default: 300)

--enable-resource-monitor

Enable resource monitoring

--no-enable-resource-monitor

Disable resource monitoring

--help

Show help information

--version

Show version number

All Commands

ironcode

Start interactive TUI (default command)

Usage

ironcode

Examples

$ ironcode # Start interactive mode

$ ironcode --model anthropic/claude-sonnet-4

$ ironcode --max-memory 500

run

Run IronCode with a message

Usage

ironcode run [message..]

Flags

-c, --continue

Continue the last session

-s, --session <id>

Continue specific session

--fork

Fork session before continuing

-m, --model <name>

Model to use (e.g., anthropic/claude-sonnet-4)

--agent <name>

Agent to use (build, plan, general)

-f, --file <path>

File(s) to attach to message

--title <string>

Session title

--format <type>

Output format (default, json)

--variant <string>

Model variant (reasoning effort)

--thinking

Show thinking blocks

Examples

$ ironcode run "Add user authentication"

$ ironcode run --continue

$ ironcode run --model anthropic/claude-sonnet-4 --file src/app.ts

agent

Manage custom agents

Usage

ironcode agent <command>

Subcommands

create

Create a new custom agent

--path <dir>Directory path for agent file

--description <text>What the agent should do

--mode <type>Agent mode (all, primary, subagent)

--tools <list>Comma-separated tools to enable

-m, --model <name>Model to use

list

List all available agents

Examples

$ ironcode agent create --description "Python testing specialist"

$ ironcode agent list

models

List available AI models

Usage

ironcode models [provider]

Flags

--verbose

Include metadata like costs

--refresh

Refresh models cache from models.dev

Examples

$ ironcode models

$ ironcode models anthropic

$ ironcode models --verbose

auth

Manage authentication credentials

Usage

ironcode auth <command>

Subcommands

login [url]

logout

Log out from a provider

list

List providers with credentials (alias: ls)

Examples

$ ironcode auth login

$ ironcode auth list

$ ironcode auth logout

session

Manage IronCode sessions

Usage

ironcode session <command>

Subcommands

list

List all sessions

-n, --max-count <n>Limit to N most recent sessions

--format <type>Output format (table, json)

Examples

$ ironcode session list

$ ironcode session list -n 10

$ ironcode session list --format json

stats

Show usage statistics

Usage

ironcode stats

Flags

--days <n>

Show stats for last N days

--tools <n>

Number of tools to show

--models <n>

Show model statistics

--project <id>

Filter by project

Examples

$ ironcode stats

$ ironcode stats --days 7

$ ironcode stats --models 5

export

Export session data as JSON

Usage

ironcode export [sessionID]

Examples

$ ironcode export

$ ironcode export abc123 > session.json

import

Import session from JSON file

Usage

ironcode import <file>

Examples

$ ironcode import session.json

$ ironcode import https://example.com/session.json

pr

Fetch and checkout GitHub PR

Usage

ironcode pr <number>

Examples

$ ironcode pr 123

mcp

Manage Model Context Protocol servers

Usage

ironcode mcp <command>

Subcommands

add

Add an MCP server

list

List MCP servers and their status (alias: ls)

auth [name]

Authenticate with OAuth-enabled MCP server

logout [name]

Remove OAuth credentials

debug <name>

Debug OAuth connection

Examples

$ ironcode mcp add

$ ironcode mcp list

$ ironcode mcp auth server-name

serve

Start headless IronCode server

Usage

ironcode serve

Examples

$ ironcode serve

$ ironcode serve --port 3000

attach

Attach to running IronCode server

Usage

ironcode attach <url>

Flags

--dir <path>

Directory to run in

-s, --session <id>

Session ID to continue

-p, --password <string>

Basic auth password

Examples

$ ironcode attach http://localhost:3000

$ ironcode attach ws://server:8080 --session abc123

upgrade

Upgrade IronCode to latest version

Usage

ironcode upgrade [target]

Flags

-m, --method <type>

Installation method (npm, brew, etc.)

Examples

$ ironcode upgrade

$ ironcode upgrade latest

$ ironcode upgrade --method npm

uninstall

Uninstall IronCode

Usage

ironcode uninstall

Flags

-c, --keep-config

Keep configuration files

-d, --keep-data

Keep session data and snapshots

--dry-run

Show what would be removed

-f, --force

Skip confirmation prompts

Examples

$ ironcode uninstall

$ ironcode uninstall --keep-data

$ ironcode uninstall --dry-run

debug

Debug tools and utilities

Usage

ironcode debug <command>

Subcommands

config

Debug configuration

paths

Show global paths

rg tree

Show directory tree

rg files

List files

rg search <pattern>

Search files

Examples

$ ironcode debug config

$ ironcode debug paths

$ ironcode debug rg tree

Quick Reference

ironcode run agent models auth session stats export import

Need More Help?

Run any command with --help for detailed information