# CmdForge Registry

The official registry of tools for [CmdForge](https://gitea.brrd.tech/rob/CmdForge) - a lightweight personal tool builder for AI-powered CLI commands.

## Browse Tools

Visit the web UI: https://cmdforge.brrd.tech (or your self-hosted instance)

Or use the CLI:
```bash
cmdforge registry browse
cmdforge registry search <query>
```

## Install a Tool

```bash
cmdforge registry install official/summarize
```

## Publish Your Own Tool

1. Create an account at the registry website
2. Generate an API token from your dashboard
3. Run `cmdforge registry publish` in your tool directory

See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.

## Repository Structure

```
CmdForge-Registry/
├── tools/                    # All published tools
│   ├── official/             # Official namespace
│   │   ├── summarize/
│   │   │   ├── config.yaml
│   │   │   └── README.md
│   │   └── translate/
│   │       ├── config.yaml
│   │       └── README.md
│   └── {username}/           # User namespaces
│       └── {toolname}/
│           ├── config.yaml
│           └── README.md
├── categories/
│   └── categories.yaml       # Category definitions
└── index.json                # Auto-generated search index
```

## License

Tools in this registry are published under their individual licenses as specified in each tool's config.yaml or README.md.
# Updated Wed 31 Dec 2025 10:36:43 PM AST