CLI Reference

The wagents CLI manages AI agent assets in this repository.

Installation

1. Clone the repository:

   git clone https://github.com/wyattowalsh/agents.git
   cd agents

2. Install with uv:

   uv sync

3. Verify installation:

   uv run wagents --version

Commands

new

Create new assets from reference templates.

wagents new skill <name>    # Create a new skill
wagents new agent <name>    # Create a new agent
wagents new mcp <name>      # Create a new MCP server

docs

Manage the documentation site.

wagents docs init        # One-time: pnpm install in docs/
wagents docs generate    # Generate MDX content pages
wagents docs dev         # Generate + launch dev server
wagents docs build       # Generate + static build
wagents docs preview     # Generate + build + preview server
wagents docs clean       # Remove generated content pages

validate

Validate all skills and agents frontmatter.

wagents validate

readme

Generate or check the README.

wagents readme           # Regenerate README.md
wagents readme --check   # Check if README is up to date

Repository Structure

• Directoryskills/

  • Directory<name>/

    • SKILL.md
    • Directoryreferences/ (optional)

      • …
• Directoryagents/

  • <name>.md
• Directorymcp/

  • Directory<name>/

    • server.py
    • pyproject.toml
    • fastmcp.json
• Directorydocs/ (this site)

  • …
• Directorywagents/ (CLI source)

  • cli.py