mirror of
https://github.com/pewdiepie-archdaemon/odysseus.git
synced 2026-09-28 19:12:19 +02:00
37 lines
1.4 KiB
Markdown
37 lines
1.4 KiB
Markdown
# Odysseus Claude Code Integration
|
|
|
|
This directory contains the Claude Code skill bundle for Odysseus.
|
|
|
|
## User Flow
|
|
|
|
1. Open Odysseus Settings > Integrations.
|
|
2. Add a Claude Agent.
|
|
3. Copy the full setup commands shown after the generated token.
|
|
4. Toggle the tools Claude is allowed to use.
|
|
5. Configure the terminal Claude Code session:
|
|
|
|
```bash
|
|
export ODYSSEUS_URL=http://your-odysseus-host:7000
|
|
export ODYSSEUS_API_TOKEN=ody_generated_token
|
|
mkdir -p ~/.claude
|
|
curl -fsSL -H "Authorization: Bearer $ODYSSEUS_API_TOKEN" "$ODYSSEUS_URL/api/claude/plugin.zip" -o /tmp/odysseus-claude-skill.zip
|
|
python3 -m zipfile -e /tmp/odysseus-claude-skill.zip ~/.claude/
|
|
```
|
|
|
|
Claude Code auto-loads anything under `~/.claude/skills/`, so the `odysseus` skill is
|
|
available in any session that has `ODYSSEUS_URL` and `ODYSSEUS_API_TOKEN` in its
|
|
environment.
|
|
|
|
## What's in the bundle
|
|
|
|
- `skills/odysseus/SKILL.md` — the skill definition Claude Code reads.
|
|
- `skills/odysseus/scripts/odysseus_api.py` — small helper that calls the scoped
|
|
`/api/codex/*` endpoints (these are the canonical scope-gated agent API; the
|
|
`codex` path is historic and shared by all agent integrations).
|
|
|
|
## Scope enforcement
|
|
|
|
The token is scope-gated. Every tool surface is checked server-side in Odysseus,
|
|
so even if Claude tries to call a forbidden endpoint, it gets `403` until the
|
|
user enables the matching toggle in Settings > Integrations > Claude Agent.
|