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)            │
├─────────────────┼─────────────────┼─────────────────────────┤
│ 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-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