yao agent
- Repo stars 7,542
- Author repo yao
- Domain
- DevOps
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @YaoApp · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# Agent Tools
Five tools for managing agents on the host, called via bash.
## agent_list
List available agents. Returns ID, name, description, and capabilities for each agent.
```bash
tai tool agent_list '{}'
tai tool agent_list '{"namespace": "smith"}'
```
| Parameter | Type | Required | Description |
|-------------|--------|----------|----------------------------------------------------------|
| `namespace` | string | no | Filter by namespace (e.g. `yao`, `smith`). Omit for all. |
## agent_download
Download a **smith-namespace** agent into the development directory for editing. **Restricted to `smith` namespace only** — for other agents, use `agent_reference`.
```bash
tai tool agent_download '{"id": "smith.weather"}'
```
| Parameter | Type | Required | Description |
|-----------|--------|----------|----------------------------------------------------------|
| `id` | string | yes | Agent ID in dot notation. Must be `smith.*`. |
Downloaded code lands in `agent-smith-dev/assistants/smith/<name>/`.
## agent_reference
Download agent source code from the host into `.references/` for **read-only study**. Any agent across all namespaces can be referenced.
```bash
tai tool agent_reference '{"id": "yao.slides"}'
tai tool agent_reference '{"id": "yao.keeper"}'
```
| Parameter | Type | Required | Description |
|-----------|--------|----------|----------------------------------------------------|
| `id` | string | yes | Agent ID in dot notation (e.g. `yao.slides`) |
Referenced code lands in `agent-smith-dev/.references/<namespace>/<name>/`.
## agent_deploy
Deploy agent source code from the sandbox development directory to the host. **Restricted to the `smith` namespace only** — attempts to deploy to other namespaces will be rejected.
```bash
tai tool agent_deploy '{"id": "smith.weather"}'
tai tool agent_deploy '{"id": "smith.weather", "message": "add SUI page"}'
```
| Parameter | Type | Required | Description |
|-----------|--------|----------|--------------------------------------------------------|
| `id` | string | yes | Agent ID in dot notation. Must use `smith` namespace. |
| `message` | string | no | Optional deploy message for logging. |
## agent_connectors
Get the current user's LLM connector matrix. Returns metadata for each role (default, heavy, light, vision, etc.) **without API keys**. Use this to understand which models are available and their capabilities.
```bash
tai tool agent_connectors '{}'
```
No parameters required.
## Guidelines
- Use `agent_list` to discover agents before downloading or referencing
- `agent_download` is for editing smith agents — code lands in `agent-smith-dev/assistants/smith/<name>/`
- `agent_reference` is for studying any agent — code lands in `agent-smith-dev/.references/<namespace>/<name>/`
- Deploy is restricted to the `smith` namespace for safety
- Connector data never includes API keys, secrets, or tokens
- All output is JSON
Sections and files
Listed in source order.
sections -> agentlist → agentdownload → agentreference → agentdeploy → agentconnectors → Guidelines
terms -> smith-namespace · Restricted to smith namespace only · read-only study · Restricted to the smith namespace only · without API keys
files/cmd -> namespace · yao · smith · agent_reference · smith.* · agent-smith-dev/assistants/smith/<name>/ · .references/ · yao.slides
body sha256 -> 71c7c5f6a6b5
agentlist
List available agents. Returns ID, name, description, and capabilities for each agent. Parameter · Type · Required · Description
namespace· string · no · Filter by namespace (e.g.yao,smith). Omit for all.agentdownload
Download a smith-namespace agent into the development directory for editing. Restricted to
smithnamespace only — for other agents, useagent_reference. Parameter · Type · Required · Descriptionid· string · yes · Agent ID in dot notation. Must besmith.*. Downloaded code lands inagent-smith-dev/assistants/smith/<name>/.agentreference
Download agent source code from the host into
.references/for read-only study. Any agent across all namespaces can be referenced. Parameter · Type · Required · Descriptionid· string · yes · Agent ID in dot notation (e.g.yao.slides) Referenced code lands inagent-smith-dev/.references/<namespace>/<name>/.agentdeploy
Deploy agent source code from the sandbox development directory to the host. Restricted to the
smithnamespace only — attempts to deploy to other namespaces will be rejected. Parameter · Type · Required · Descriptionid· string · yes · Agent ID in dot notation. Must usesmithnamespace.message· string · no · Optional deploy message for logging.agentconnectors
Get the current user's LLM connector matrix. Returns metadata for each role (default, heavy, light, vision, etc.) without API keys. Use this to understand which models are available and their capabilities. No parameters required.