Skip to content

CLI Reference

A quick reference for every CmdForge command. Bookmark this page—you'll come back to it.

Tool Commands

Command Description
cmdforge Launch the Visual Builder (desktop GUI)
cmdforge list List all installed tools
cmdforge create Create a new tool (interactive wizard)
cmdforge edit <tool> Open tool config in your editor
cmdforge delete <tool> Remove a tool
cmdforge test <tool> Test a tool with mock provider
cmdforge run <tool> Run a tool directly (without wrapper)
cmdforge refresh Regenerate all wrapper scripts
cmdforge docs <tool> View or edit tool documentation
cmdforge check <tool> Check if tool dependencies are installed

Interactive Tool Picker (cf)

The cf command provides a fast, fuzzy-search picker for running tools interactively. Instead of remembering exact tool names, just type a few characters to filter and select.

# Launch the picker
cf

# Pipe input through the picker
cat document.txt | cf

# Chain pickers for interactive pipelines
cf | cf | cf

Controls:

  • Type - Fuzzy filter tools by name or description
  • ↑/↓ - Navigate the list
  • Enter - Run the selected tool
  • Tab - Configure arguments before running (if tool has arguments)
  • Esc - Cancel

Interactive Pipelines

Chain cf commands to build pipelines on the fly: cat data.txt | cf | cf lets you pick a tool, then pick another tool to process its output. The picker UI is shown on stderr so it doesn't interfere with piped data.

Registry Commands

Command Description
cmdforge registry search <query> Search for tools
cmdforge registry install <tool> Install a tool from registry
cmdforge registry uninstall <tool> Uninstall a registry tool
cmdforge registry info <tool> Show tool details
cmdforge registry publish <tool> Publish a tool to registry
cmdforge registry my-tools List your published tools
cmdforge registry browse Browse registry (interactive TUI)

Collection Commands

Command Description
cmdforge collections list List available collections
cmdforge collections info <name> Show collection details
cmdforge collections install <name> Install all tools in collection

Provider Commands

Command Description
cmdforge providers install Interactive provider installation guide
cmdforge providers list List configured providers
cmdforge providers check Check which providers are available
cmdforge providers add <name> <cmd> Add a new provider
cmdforge providers remove <name> Remove a provider
cmdforge providers test <name> Test a provider

Project Commands

Command Description
cmdforge init Create cmdforge.yaml manifest
cmdforge add <tool> Add tool to project dependencies
cmdforge install Install project dependencies
cmdforge deps Show project dependencies

Config Commands

Command Description
cmdforge config show Show current configuration
cmdforge config set <key> <value> Set a configuration value
cmdforge config connect <username> Connect to registry account

Useful Global Flags

Flag Description
--help Show help for any command
--version Show CmdForge version
--provider <name> Override provider for tool execution

Important File Locations

Path Contents
~/.cmdforge/ Tool configs directory
~/.cmdforge/<tool>/config.yaml Individual tool configuration
~/.cmdforge/providers.yaml Provider configurations
~/.local/bin/ Tool wrapper scripts
./cmdforge.yaml Project dependency manifest