# AutoVault API Reference

Current v0.4.0 surfaces are the local CLI, source ESM library exports, local stdio MCP, and remote Streamable HTTP MCP at /mcp. There is no public REST API or separately published SDK package yet. MCP tools are the agent-facing API.

## Current v0.4.0 surfaces

- CLI commands for add install, remove/uninstall cleanup, profile sync, doctor checks, local skill search/list/which, repo audit, setup, capability resolve, and remote service startup.
- Source ESM library exports for resolveCapabilities, syncProfiles, addSkill, updateSkill, deleteSkill, proposeSkill, transforms, auditRepo, and profile discovery.
- MCP tools for discovery/full reads through get_skill, trusted adds, updates, deletes, proposals, and drift checks.
- Remote Streamable HTTP MCP with OAuth and role-aware filtering at /mcp.

## Agent guidance

Prefer inventory lookup first, full reads second, and get_skill with include_resources when packaged resources are needed. Use local sync-profiles when a filesystem-native host needs files under its local skill root.

## add examples

```bash
autovault add ./skills/skill-author --sync-profiles --yes
autovault add autoworks-ai/autovault:skills/skill-author/SKILL.md --sync-profiles --yes
autovault add skill-slug --source agentskills --sync-profiles --agent codex --yes
autovault add https://example.com/SKILL.md --source url --no-sync-profiles --yes
```

`autovault add` infers the source for common local paths and GitHub inputs. Use `--source` when the input is ambiguous, `--agent` when a remote skill does not declare target agents, and `--sync-profiles` when visible agent roots should be refreshed.