toolsforagents

CLI for the toolsforagents.dev registry - discover and submit agent-friendly tools.

Install

npm install -g toolsforagents

Usage

# List all verified tools
tfa list

# List only CLI tools
tfa list --type cli

# Search for tools
tfa search task

# Get tool details
tfa get haasonsaas/things-agent-cli

# Submit a tool
tfa submit \
  --name my-tool \
  --repo user/my-tool \
  --description "What it does" \
  --type cli \
  --language TypeScript \
  --categories "productivity,automation" \
  --principles "json,errors,bulk"

Output Modes

By default, all output is JSON for agent consumption:

tfa list
# {"tools":[...],"count":1}

Use --text for human-readable output:

tfa list --text
# ◆ 1 verified tool
# CLI things-agent-cli
#     haasonsaas/things-agent-cli
#     A CLI for managing Apple Things tasks...

Commands

Command	Description
list [--type <type>]	List verified tools
search <query>	Search tools by name
get <repo>	Get tool details
submit	Submit a new tool

Submit Options

Flag	Required	Description
--name	Yes	Tool name
--repo	Yes	GitHub repo (user/repo)
--description	Yes	What it does
--type	Yes	cli, mcp, api, sdk, library
--language	No	Primary language
--categories	No	Comma-separated list
--principles	No	json, errors, natural, brief, bulk, local, health, deeplinks

Agent-Friendly Design

This CLI follows toolsforagents.dev principles:

• JSON Output - All commands output JSON by default
• Structured Errors - Errors include error field in JSON
• Brief Commands - list, search, get for quick context

License

MIT