CLI Tools

CodeForge installs 22 tools and utilities in your DevContainer, covering session management, code quality, language runtimes, and development infrastructure. Every tool is on your PATH from the first terminal session — no manual installation required.

Session & Claude Tools

These tools manage your Claude Code sessions, track usage, and provide monitoring capabilities.

cc / claude

Launch Claude Code with the full CodeForge configuration — custom system prompt, all plugins, agents, and skills active.

# Start a CodeForge-configured Claude session
cc

# Equivalent — 'claude' is an alias for the same configuration
claude

Both cc and claude set up the CodeForge system prompt, enable plan permission mode, and load all configured plugins. This is the primary way to start Claude Code in a CodeForge environment.

ccraw

Launch Claude Code without any CodeForge configuration — no custom system prompt, no plugins, no agents. Useful for debugging or when you need vanilla Claude Code behavior.

# Start vanilla Claude Code
ccraw

ccw

Launch Claude Code with a writing-focused system prompt, optimized for documentation and content creation tasks.

# Start Claude in writing mode
ccw

ccms — Session History Search

Currently Disabled

The ccms feature is currently commented out in devcontainer.json. A replacement tool is pending. The documentation below is preserved for reference.

Search through your Claude Code session history (JSONL files) with boolean queries, role filtering, and time scoping. Built in Rust for fast searching across large session archives.

# Basic search across all sessions
ccms "authentication flow"

# Search within the current project only
ccms --project "$(pwd)" "query"

# Filter by role — find Claude's past decisions
ccms -r assistant "what was decided about the database schema"

# Filter by role — find what you previously asked
ccms -r user "auth approach"

# Boolean queries
ccms "(auth OR authentication) AND NOT test"

# Time-scoped search
ccms --since "1 day ago" "recent work"
ccms --since "1 week ago" "architecture decisions"

# JSON output for structured parsing
ccms -f json "query" -n 10

# Statistics about your session history
ccms --stats ""

# Interactive TUI mode (not available from within Claude)
ccms

Project scoping

Always pass --project "$(pwd)" when searching from within a project to avoid results from unrelated projects leaking into your search.

ccusage — Usage Statistics

View your Claude API usage statistics, including token counts, costs, and session summaries. Installed via npm from the ccusage project.

# View usage statistics
ccusage

ccburn — Token Burn Analysis

Analyze token consumption patterns across sessions to understand usage efficiency and identify sessions with unusually high token burn.

# Analyze token burn rate
ccburn

claude-dashboard

A web-based session monitoring dashboard that provides real-time visibility into active Claude sessions, resource usage, and session history. Runs on port 7847.

# Launch the dashboard
claude-dashboard

claude-monitor

Real-time terminal-based Claude session monitor. Shows active sessions and their current status.

# Start the session monitor
claude-monitor

agent-browser

A headless Chromium browser (Playwright-based) available for agents that need to inspect web content or take screenshots.

# Launch the agent browser
agent-browser

check-setup

Verify your CodeForge installation health — checks that all expected tools are installed, plugins are loaded, and configuration is valid.

# Run the setup health check
check-setup

cc-tools

List all available CodeForge CLI tools with their installation status and versions.

# Show all tools and their status
cc-tools

This displays a formatted table showing every tool, whether it is installed, and its version number.

Code Quality Tools

These tools are used both manually and automatically by the Auto Code Quality Plugin to maintain code standards.

Command	Languages	Purpose	Example
ruff	Python	Linting and formatting	ruff check src/ && ruff format src/
biome	JS/TS/JSON	Linting and formatting	biome check src/
shellcheck	Shell	Script linting	shellcheck scripts/*.sh
shfmt	Shell	Script formatting	shfmt -w scripts/*.sh
dprint	MD/TOML/JSON	Formatting	dprint fmt
hadolint	Dockerfile	Linting	hadolint Dockerfile

Automatic quality

You rarely need to run these tools manually. The Auto Code Quality plugin runs the appropriate linter and formatter automatically when Claude edits files. See Auto Code Quality for details.

Code Intelligence Tools

Command	Purpose	Details
sg / ast-grep	Structural code search using AST patterns	Full documentation
tree-sitter	Syntax tree parsing and symbol extraction	Full documentation

These tools are covered in depth on the Code Intelligence page.

Language Runtimes & Package Managers

CodeForge includes modern language runtimes and fast package managers so you can work with multiple languages out of the box.

Tool	Version	Purpose	Example
Node.js	via nvm	JavaScript runtime	node --version
Python	3.14 via uv	Python runtime	python --version
Rust	via rustup	Rust toolchain (opt-in — commented out by default)	cargo --version
Bun	latest	Fast JS runtime and package manager	bun install
uv	latest	Fast Python package manager	uv pip install requests
Go	via feature	Go toolchain	go version
GitHub CLI (gh)	latest	GitHub operations from the terminal	gh pr create

uv for Python

CodeForge uses uv as the default Python package manager. It is significantly faster than pip for dependency resolution and installation. Use uv pip install instead of pip install for the best experience.

Development Utilities

Tool	Purpose	Example
tmux	Terminal multiplexer for session management	tmux new -s work
jq	JSON processor for command-line data manipulation	cat data.json | jq '.results[]'
git	Version control (pre-configured)	git log --oneline -10
docker	Container management (host Docker socket mounted)	docker ps
LSP servers	Language servers for code intelligence	See Code Intelligence

Complete Tool Reference

#	Command	Category	Description
1	cc / claude	Session	Claude Code with CodeForge config
2	ccraw	Session	Vanilla Claude Code
3	ccw	Session	Claude Code in writing mode
4	ccms	Session	Session history search (currently disabled)
5	ccusage	Session	API usage statistics
6	ccburn	Session	Token burn analysis
7	ccstatusline	Session	Terminal statusline
8	claude-dashboard	Session	Web-based session dashboard
9	claude-monitor	Session	Real-time session monitor
10	agent-browser	Session	Headless browser for agents
11	check-setup	Session	Installation health check
12	cc-tools	Session	List all available tools
13	ruff	Quality	Python linting and formatting
14	biome	Quality	JS/TS/JSON linting and formatting
15	shellcheck	Quality	Shell script linting
16	shfmt	Quality	Shell script formatting
17	dprint	Quality	Markdown/TOML/JSON formatting
18	hadolint	Quality	Dockerfile linting
19	sg / ast-grep	Intelligence	Structural code search
20	tree-sitter	Intelligence	Syntax tree parsing
21	pyright	Intelligence	Python LSP server
22	typescript-language-server	Intelligence	TypeScript/JS LSP server

Related

• Code Intelligence — ast-grep, tree-sitter, and LSP details
• Commands Reference — complete command table
• Auto Code Quality — how quality tools are automated