Skip to content

tools.md

Latest commit

 

History

History
238 lines (172 loc) · 8.58 KB

tools.md

File metadata and controls

238 lines (172 loc) · 8.58 KB
title CLI Tools
description Reference for all CLI tools and utilities installed in the CodeForge DevContainer.
sidebar
order
4

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

:::caution[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

:::tip[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

:::tip[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

:::note[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