oraclelisted
Install: claude install-skill OraclePersonal/Oracle
# Oracle Skill (this repo's own MCP server)
This project registers its own MCP tools under the `oracle_*` prefix (see
`src/mcp/server.ts`). It bundles four capabilities in one server:
- **Ask** — `oracle_ask`: one entry point for Q&A; pass `files` to include real
code, omit for plain conversation. Pass an `oracle` profile to auto-scope memory.
- **Agent** — `oracle_agent`: autonomous coding loop that reads/writes/edits files
and runs shell commands until a task is done (needs `anthropic`/`opencode`; see
`docs/AGENT.md`).
- **Memory** — `.oracle-memory/` fact/insight/chunk/working entries, scoped per agent.
- **Identity** — your profile + Oracle's persona, auto-injected into every `oracle_ask`.
## 0. Setup (once per workspace)
```bash
oracle setup-mcp --client claude-code
```
This registers the built server (`oracle.js`) with Claude Code. After that,
all tools below appear natively in the session — no separate process to run.
## 1. Session-start sequence
```
1. oracle_identity_show
→ see your saved identity + Oracle's persona (skip if not set up yet)
2. oracle_skills
→ list available skills (review, debug, security, ...) before consulting
3. oracle_oracle_list
→ see registered oracle profiles (skill+model+provider+memory bundles)
4. oracle_memory_list { agent: "<your-name>", limit: 5 }
→ surface recent facts/insights before starting work, if memory is relevant
```
If identity has never been set up, call `oracle_identity_setup` once with
nam