EverOS: Skill for Claude Code

/verify-everos - check a change on a real server

Unit and integration tests run the code with stand-ins; this is how to see the real everos server do it. Grown one task at a time: each task adds the features it actually walked (see the feature map at the end), nothing more.

1. Start your own instance

Never use ~/.everos or a server someone else started. Give every check its own root and port.

ROOT=$(mktemp -d)/root; PORT=18611
lsof -nP -iTCP:$PORT -sTCP:LISTEN          # must print nothing
uv run everos init --root "$ROOT"
EVEROS_LLM__API_KEY=$OPENROUTER_API_KEY \
EVEROS_EMBEDDING__API_KEY=$DEEPINFRA_API_KEY \
EVEROS_RERANK__API_KEY= \
  uv run everos server start --root "$ROOT" --port $PORT > "$ROOT.log" 2>&1 &
echo $! > "$ROOT.pid"

The shipped defaults point the LLM at OpenRouter and the embedding at DeepInfra, so those two keys are all it needs. Reflection is off by default (docs/reflection.md); to turn it on, replace the $ROOT/ome.toml that init scaffolds with [strategies.reflect_episodes]\nenabled = true before starting, as the acceptance tests do.

2. Is it ready?

curl -s http://127.0.0.1:$PORT/health answers 200 within a few seconds. Its cascade.pending is the number of markdown changes not yet in the index. Before reading the index, poll it once a second until it reads 0 on two consecutive samples (docs/api.md, and wait_converged in tests/acceptance/memory_delete/observe.py): a single 0 can come between a markdown write and its projection being queued. A server that exits instead: the last lines of $ROOT.log (usually a missing key).

3. Drive it

• HTTP: POST /api/v2/memory/add, /flush, /delete (user_id / agent_id / session_id), /delete_by_ids ({"memory_type": "episode", "memory_ids": ["<owner>_<entry_id>"]}), /memory/search, /memory/get. Run Reflection now with POST /api/v2/ome/trigger {"name": "reflect_episodes", "force": true}.
• Claude Code, the way users do it: run everos-mcp against your port and start Claude Code with only that server, in a tmux socket of your own (tmux -L <name>), sending keys and reading the pane: