Skip to main content

CmdForge Overview

A lightweight personal tool builder for AI-powered CLI commands.

ResourceURL
Public Websitehttps://cmdforge.brrd.tech/
Git Repositoryhttps://gitea.brrd.tech/rob/CmdForge
Registry Repohttps://gitea.brrd.tech/rob/CmdForge-Registry

Components​

┌─────────────────────────────────────────────────────────────┐
│                       CmdForge                               │
├─────────────────┬─────────────────┬─────────────────────────┤
│   CLI + GUI     │   Web UI        │   Registry              │
│   (cmdforge)    │   (Flask)       │   (API + DB)            │
│   (cf picker)   │                 │                         │
├─────────────────┼─────────────────┼─────────────────────────┤
│ Local install   │ cmdforge.brrd.  │ Tool publishing         │
│ ~/.cmdforge/    │ tech            │ Search, download        │
│ PySide6 desktop │                 │ User accounts           │
└─────────────────┴─────────────────┴─────────────────────────┘

Key Directories​

Development (AI-Server)​

~/PycharmProjects/CmdForge/          # Source code
~/.cmdforge/                          # Local tools storage
~/.local/bin/cmdforge                 # CLI symlink

Production (OpenMediaVault)​

/srv/mergerfs/data_pool/home/rob/cmdforge-registry/   # Deployed code
/tmp/cmdforge-data/                                    # Runtime database

Recent Changes​

  • 2026-02-02: Semantic Search (AI) - Find tools by describing what you need in natural language using Ollama embeddings (nomic-embed-text). Available via CLI (cmdforge registry describe), GUI ("Describe what you need" input), and API (/api/v1/tools/semantic-search)
  • 2026-01-26: CLI remove command - Added cmdforge remove <tool> to remove dependencies from manifest
  • 2026-01-26: Improved add UX - cmdforge add now shows "Already installed" for local tools instead of registry errors
  • 2026-01-26: Hash verification fix - Fixed content hash mismatch for registry tools
  • 2026-01-18: Interactive Tool Picker - Added cf command for fuzzy-search tool selection with piping support
  • 2026-01-17: Collections CLI - Added cmdforge collections list/info/install commands
  • 2026-01-17: Admin collections UI - Web dashboard for managing tool collections
  • 2026-01-14: GUI conversion - Replaced urwid TUI with PySide6 desktop GUI
  • 2026-01-14: Modern GUI with sidebar navigation (My Tools, Registry, Providers)
  • 2026-01-14: GUI Tool Builder for creating/editing tools visually
  • 2026-01-14: GUI Registry browser with search and one-click install
  • 2026-01-14: GUI Connect dialog with polling-based account pairing
  • 2026-01-14: App pairing - connect GUI to web account without manual token copying
  • 2026-01-14: cmdforge config connect <username> command for CLI-based pairing
  • 2026-01-14: "Connections" dashboard replaces "API Tokens" for simpler app management
  • 2026-01-14: Private tool sync - auto-publish tools privately when connected
  • 2026-01-13: Tool search and filtering with faceted results
  • 2026-01-13: Docker containers: Dockerfile.ready (pre-installed), Dockerfile.test-install (fresh)
  • 2026-01-13: Interactive installer script (install.sh)
  • 2026-01-13: Database migration system (auto-adds missing columns)
  • 2026-01-13: Gunicorn production server (replaced Flask dev server)
  • 2026-01-13: CI/CD auto-deploy via Gitea webhook
  • 2026-01-13: Full ToolSource support in registry (source_json)
  • 2026-01-13: Improved error messages with line numbers and call stacks
  • 2026-01-03: Migrated from SmartTools to CmdForge
  • 2026-01-03: Added source field support for Fabric imports