README

Discover, install, and manage skills and toolkits from Coqui Space directly from your Coqui Bot agent loop.

Features

Search — find skills and toolkits on Coqui Space by keyword
Install — download skills (ZIP → .workspace/skills/) or toolkits (Composer → .workspace/)
Update — pull latest versions of installed content
Disable / Enable — toggle content without permanently removing it
Remove — soft-disable or hard-purge installed skills and toolkits
Star — give community feedback on skills you use

Requirements

PHP 8.4+
ext-zip, ext-json
Composer

Installation

The Space Manager ships with Coqui core. If you need to install it separately:

composer require coquibot/coqui-toolkit-space-manager

Coqui auto-discovers the toolkit via extra.php-agents.toolkits — no manual registration required.

Credentials

The Space Manager works without authentication for browsing and installing. To star skills or access user-specific features, set credentials via the credentials tool in your Coqui session:

credentials(action: "set", key: "COQUI_SPACE_USERNAME", value: "your-username")
credentials(action: "set", key: "COQUI_SPACE_APP_PASSWORD", value: "xxxx xxxx xxxx xxxx xxxx xxxx")

Generate an Application Password in your WordPress profile at coqui.space → Users → Profile → Application Passwords.

Credential	Required	Description
`COQUI_SPACE_USERNAME`	For auth	WordPress username on coqui.space
`COQUI_SPACE_APP_PASSWORD`	For auth	WordPress Application Password
`COQUI_SPACE_URL`	No	Custom API URL (default: `https://coqui.space/wp-json/coqui/v1`)

Tools Reference

`space_search`

Search Coqui Space for skills and toolkits by keyword.

Parameter	Type	Required	Description
`query`	string	Yes	Search keyword(s)
`type`	enum	No	`all`, `skills`, or `toolkits` (default: `all`)
`limit`	int	No	Max results per type, 1-50 (default: 10)

`space_skill_details`

Get full metadata, versions, and publisher info for a skill.

Parameter	Type	Required	Description
`slug`	string	Yes	Skill slug on Coqui Space

`space_toolkit_details`

Get full metadata for a toolkit (Composer package).

Parameter	Type	Required	Description
`package`	string	Yes	Package name in `vendor/package` format

`space_install`

Install a skill or toolkit from Coqui Space. Auto-detects type: names with / are toolkits, without are skills.

Parameter	Type	Required	Description
`name`	string	Yes	Skill slug or toolkit `vendor/package`
`version`	string	No	Version constraint (default: latest)
`force`	bool	No	Overwrite existing (default: false)

`space_update`

Update an installed skill or toolkit to the latest version.

Parameter	Type	Required	Description
`name`	string	Yes	Skill name or toolkit `vendor/package`
`force`	bool	No	Force update even if version appears current

`space_installed`

List all installed skills and toolkits with status and source. No parameters.

`space_disable`

Disable a skill or toolkit without removing it.

Parameter	Type	Required	Description
`name`	string	Yes	Skill name or toolkit `vendor/package`

`space_enable`

Re-enable a previously disabled skill or toolkit.

Parameter	Type	Required	Description
`name`	string	Yes	Skill name or toolkit `vendor/package`

`space_remove`

Remove an installed skill or toolkit.

Parameter	Type	Required	Description
`name`	string	Yes	Skill name or toolkit `vendor/package`
`purge`	bool	No	Permanently delete files (default: false, disables only)

`space_star`

Star or unstar a skill on Coqui Space. Requires authentication.

Parameter	Type	Required	Description
`slug`	string	Yes	Skill slug to star/unstar
`action`	enum	No	`star` or `unstar` (default: `star`)

How Content Types Work

Skills

Downloaded as ZIP archives from the Coqui Space API
Extracted to .workspace/skills/{name}/
Tracked via .space-origin.json metadata file
Available immediately after install — no restart needed
Disable/enable toggles a .disabled suffix on the directory

Toolkits

Standard Composer packages installed via composer require into .workspace/
Require a restart after install/update/remove/enable/disable (ToolkitDiscovery runs at boot)
Disable tracks the version constraint in .space-state.json for seamless re-enablement

Gated Operations

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

Tool	Gate
`space_install`	All invocations
`space_update`	All invocations
`space_remove`	When `purge=true`
`space_disable`	All invocations
`space_enable`	All invocations

Excluded Packages

These core Coqui toolkits cannot be managed through the Space Manager:

coquibot/coqui-toolkit-space-manager
coquibot/coqui-toolkit-composer
coquibot/coqui-toolkit-packagist

Development

# Install dependencies
composer install

# Run tests
composer test

# Static analysis
composer analyse

License

MIT

coquibot / coqui-toolkit-space-manager

Maintainers

Package info

Statistics

Security