docs: add local agent smoke runbook#291
Conversation
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
Note
Copilot was unable to run its full agentic suite in this review.
Adds a local agent “smoke test” runbook to validate multi-runtime safety and indexing behavior when using a local EverOS service, and links it from the docs index.
Changes:
- Added a step-by-step smoke runbook for writing, syncing, reading, deleting, and verifying memory absence across runtimes.
- Documented proxy-bypass setup for loopback requests.
- Linked the new runbook from
docs/index.md.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
| docs/local-agent-smoke.md | New runbook documenting an end-to-end local smoke test across two runtimes, including deletion/absence verification. |
| docs/index.md | Adds the new runbook to the operations docs table for discoverability. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| ```bash | ||
| EPISODE_DIR="$EVEROS_MEMORY__ROOT/$APP_ID/$PROJECT_ID/users/$USER_ID/episodes" | ||
| find "$EPISODE_DIR" -type f -name 'episode-*.md' -print | ||
| rm "$EPISODE_DIR"/episode-*.md |
| Terminal A: | ||
|
|
||
| ```bash | ||
| export EVEROS_MEMORY__ROOT="$(mktemp -d /tmp/everos-agent-smoke-XXXXXX)" |
|
Addressed Copilot review feedback in 01f6f77.\n\n- Replaced the mktemp-based smoke root command with python3 tempfile.mkdtemp() to avoid GNU/BSD mktemp differences.\n- Replaced the rm glob deletion with find ... -print -delete, and added a note to stop if no episode file is printed.\n- Verified git diff --check, tempfile creation, empty-match delete behavior, and existing episode deletion locally. |
Summary
Why
Agent runtimes often run in shells with proxy variables, separate process state, and automatic hook ambitions. This runbook gives builders a small manual proof before they wire EverOS into production agent hooks.
Validation
git diff --checkapi.md,how-memory-works.md,storage_layout.md,cli.md, andSECURITY.mdScope
Docs only. No runtime behavior changes.