README

Coqui Mods manager toolkit — browse, install, update, and manage skills and toolkits from agentcoqui.com.

Installation

composer require coquibot/coqui-toolkit-mod-manager

The toolkit is auto-discovered by Coqui via extra.php-agents.toolkits in composer.json. No additional configuration needed.

Credentials

Set credentials via the Coqui credentials tool:

credentials(action: "set", key: "COQUI_MODS_API_TOKEN", value: "cqs_...")

Most read operations work without authentication. Publish, delete, account, collections, reviews, notifications, and other social write actions now live in coquibot/coqui-toolkit-mod-publish.

Tools

The toolkit provides three tools plus the self-registering /mods REPL command.

mods_skills — Skill Discovery & Installation

mods_toolkits — Toolkit Discovery & Installation

mods — Management & Discovery

Identifier convention: Names containing / are treated as toolkits (Composer packages). Names without / are treated as skills (directory names).

/mods — REPL Command

The package also owns the external /mods slash command in Coqui's REPL.

Supported flows:

• /mods search <query>
• /mods install <owner/name|vendor/package>
• /mods remove <identifier>
• /mods installed
• /mods update <identifier>

Standalone Usage

<?php

use CoquiBot\ModManager\ModManagerToolkit;

// From environment variables
$toolkit = ModManagerToolkit::fromEnv();

// Or with explicit configuration
$toolkit = new ModManagerToolkit(
    urlResolver: static fn() => 'https://agentcoqui.com/api/v1',
    tokenResolver: static fn() => getenv('COQUI_MODS_API_TOKEN') ?: '',
    workspaceDir: '/path/to/.workspace',
);

// Get tools
foreach ($toolkit->tools() as $tool) {
    echo $tool->name() . ': ' . $tool->description() . "\n";
}

// Execute a tool directly
$tool = $toolkit->tools()[0]; // mods_skills
$result = $tool->execute(['action' => 'search', 'query' => 'code review']);
echo $result->content;

Gated Operations

The following operations require user confirmation (unless --auto-approve is enabled):

• mods_skills: install, update
• mods_toolkits: install, update
• mods: disable, enable, remove

Development

# Install dependencies
composer install

# Run tests
composer test

# Static analysis
composer analyse

Architecture

src/
├── Api/
│   └── ModClient.php            # HTTP client for all API endpoints
├── Config/
│   └── ModRegistry.php          # Constants, excluded packages, helpers
├── Installer/
│   ├── SkillInstaller.php       # Skill lifecycle (ZIP download/extract)
│   └── ToolkitInstaller.php     # Toolkit lifecycle (Composer-based)
├── Tool/
│   ├── ModsSkillsTool.php       # mods_skills tool
│   ├── ModsToolkitsTool.php     # mods_toolkits tool
│   └── ModsManageTool.php       # mods tool
├── Command/
│   └── ModsCommandHandler.php   # /mods REPL command handler
└── ModManagerToolkit.php        # ToolkitInterface entry point

License

MIT