ouroboros-config

Opens and edits Ouroboros settings via browser GUI, web server, or conversational CLI commands.

5.7k|578|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/Q00/ouroboros --skill ouroboros-config
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ouroboros-config
Source: https://github.com/Q00/ouroboros/tree/main/skills/config
Command: npx skills add https://github.com/Q00/ouroboros --skill ouroboros-config

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ouroboros-ai.

What problem does it solve?

Changing Ouroboros runtime and model settings requires editing ~/.ouroboros/config.yaml correctly, which is error-prone and awkward when the agent runs on a remote host or a chat-only gateway with no browser access.

Core Features & Use Cases

  • Local GUI settings: Launches ouroboros config to serve a browser-based settings app for per-stage runtime and model selection, with a uvx fallback when the CLI is not on PATH.
  • Remote host serving: Runs ouroboros config --web --host 0.0.0.0 --no-browser and relays the URL plus SSH tunnel command for machines the user reaches over the network.
  • Conversational configuration: Uses ouroboros config show and validated config set commands to change agents, models, and LLM backends entirely in chat when no browser path exists.
  • Use Case: An agent running on a headless SSH server needs its evaluation model changed; the skill serves the settings UI on the network and hands the user a tunnel command to reach it.

Quick Start

Ask the agent to open the Ouroboros settings or change the model for a pipeline stage, and it will pick the right branch for your environment.

Frequently Asked Questions about ouroboros-config

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I open the Ouroboros settings GUI?

Run `ouroboros config` (or `ooo config`) in a local agent session. It serves a settings web app on localhost and auto-opens the browser; if the CLI is not on PATH, the uvx fallback with ouroboros-ai[tui] is used.

How do I change the model for a specific Ouroboros stage?

Use validated setters such as `ouroboros config set execution.default_model <model>` for execute or `evaluation.semantic_model` for evaluate. Confirm the result with `ouroboros config show`.

Can I configure Ouroboros on a remote server without a browser?

Yes. Run `ouroboros config --web --host 0.0.0.0 --no-browser` and open the printed URL, or use the SSH tunnel command it prints. On chat-only gateways, drive settings conversationally with config show and config set.

What happens if a config set value is invalid?

The setter rejects invalid keys or values and returns a validation error listing the valid options. The skill relays that error verbatim so you can pick an accepted value.

Why is the ouroboros command not found when opening settings?

Marketplace-plugin installs may expose only the MCP server without the CLI on PATH. Use `uvx --python '>=3.12' --from 'ouroboros-ai[tui]' ouroboros config`, or `uv run ouroboros config` in a development checkout.