Syke
Read the user's memex before doing anything else. It is the current map of what is active, what changed, and where deeper evidence lives.
Canonical memex path: ~/.syke/MEMEX.md
When to Use
syke ask: deeper timeline and evidence-backed queries
syke memex: fastest read of the current memex
syke record: write observations back into memory
syke status: quick operational snapshot
syke doctor: deeper diagnostic when setup or runtime looks wrong
Quick Reference
| Command |
Use |
Exit 0 |
Exit 1 |
syke ask "question" |
Deep memory query |
Answer on stdout |
Error on stderr, stdout empty |
syke memex |
Current memex |
Memex on stdout |
Error message |
syke record "text" |
Write observation |
Confirmation |
Error message |
syke status |
Runtime snapshot |
Status on stdout |
Error message |
syke doctor |
Health check |
All OK |
Issues found |
Procedure
- Read the memex already in context or call
syke memex.
If you need the file directly, start with ~/.syke/MEMEX.md.
- Use
syke ask when the memex is not enough.
- Use
syke record after useful work so the next session inherits it.
- Use
syke status for a quick state check.
- Use
syke doctor when setup or runtime looks wrong.
Pitfalls
- If
syke ask fails, do not treat stderr as the answer. Fall back to syke memex.
- If
syke ask is killed by a caller timeout, fall back to syke memex.
- Some sandboxes can read the memex but cannot open the live store. In those cases, use
syke memex or the injected memex there, and run syke ask from a trusted host shell if needed.
- If the memex is empty, Syke may not be set up yet or synthesis may not have produced a useful memex.
- The background loop can lag behind the newest event.
syke ask can still search the underlying timeline.
Verification
- After
syke ask, check the exit code. Exit 0 means answer on stdout. Exit 1 means failure on stderr.
- After
syke record, exit 0 means the observation was written.
- After setup,
syke doctor confirms health.
Setup & Onboarding
If Syke is not installed or configured, guide setup first.
For humans at a terminal:
- Install:
pipx install syke (or uv tool install syke)
- Run:
syke setup
- Follow the interactive provider, source, and daemon prompts.
- Confirm with
syke doctor.
For unattended agents, installers, and CI:
- Run
syke setup --agent.
- Parse the JSON
status, next_steps, and exit_code fields.
- If
status is "needs_runtime", install Node.js 20+ (22 LTS recommended)
and rerun syke setup --agent.
- If
status is "needs_provider", configure provider auth with
syke auth set <provider> --api-key <API_KEY> --use or
syke auth login <provider> --use, then rerun syke setup --agent.
- If
status is "complete", stop setup work and follow the returned
next_steps. Do not loop on setup.
- If
status is "failed", read the error field and fix that issue.
Common providers: anthropic, openai, azure-openai-responses, kimi-coding, openrouter.
For Azure, also pass --base-url https://<resource>.openai.azure.com/openai/v1 and --model <model>.
Provider Commands
| Command |
What It Does |
syke auth status |
Show selected provider, auth source, model, and endpoint |
syke auth use <name> |
Switch active provider |
syke auth set <name> --api-key <KEY> --use |
Store credentials and make this the active provider |
syke config show |
Show effective config |
Provider resolution: CLI --provider flag > SYKE_PROVIDER env > Pi defaultProvider in ~/.syke/pi-agent/settings.json.
1---2name: syke3description: "Local-first cross-harness memory for agents. Syke observes activity across supported harnesses, keeps a current memex in context, and gives agents `syke ask`, `syke memex`, and `syke record` for continuity across sessions."4version: 0.5.105author: saxenauts6license: AGPL-3.0-only7metadata:8 source: https://skillmd.com/skills/skillmds/syke9 hermes:10 tags: [Memory, Context, Identity, Cross-Platform, Agentic-Memory]11 related_skills: []12 requires_toolsets: [terminal]13 requires:14 bins: ["syke"]15 install:16 - id: pipx17 kind: pipx18 package: syke19 bins: ["syke"]20 label: "Install Syke (pipx)"21---222324# Syke2526Read the user's memex before doing anything else. It is the current map of what is active, what changed, and where deeper evidence lives.2728Canonical memex path: `~/.syke/MEMEX.md`2930## When to Use3132- **`syke ask`**: deeper timeline and evidence-backed queries33- **`syke memex`**: fastest read of the current memex34- **`syke record`**: write observations back into memory35- **`syke status`**: quick operational snapshot36- **`syke doctor`**: deeper diagnostic when setup or runtime looks wrong3738## Quick Reference3940| Command | Use | Exit 0 | Exit 1 |41|---------|-----|--------|--------|42| `syke ask "question"` | Deep memory query | Answer on stdout | Error on stderr, stdout empty |43| `syke memex` | Current memex | Memex on stdout | Error message |44| `syke record "text"` | Write observation | Confirmation | Error message |45| `syke status` | Runtime snapshot | Status on stdout | Error message |46| `syke doctor` | Health check | All OK | Issues found |4748## Procedure49501. Read the memex already in context or call `syke memex`.51 If you need the file directly, start with `~/.syke/MEMEX.md`.522. Use `syke ask` when the memex is not enough.533. Use `syke record` after useful work so the next session inherits it.544. Use `syke status` for a quick state check.555. Use `syke doctor` when setup or runtime looks wrong.5657## Pitfalls5859- If `syke ask` fails, do not treat stderr as the answer. Fall back to `syke memex`.60- If `syke ask` is killed by a caller timeout, fall back to `syke memex`.61- Some sandboxes can read the memex but cannot open the live store. In those cases, use `syke memex` or the injected memex there, and run `syke ask` from a trusted host shell if needed.62- If the memex is empty, Syke may not be set up yet or synthesis may not have produced a useful memex.63- The background loop can lag behind the newest event. `syke ask` can still search the underlying timeline.6465## Verification6667- After `syke ask`, check the exit code. Exit 0 means answer on stdout. Exit 1 means failure on stderr.68- After `syke record`, exit 0 means the observation was written.69- After setup, `syke doctor` confirms health.7071## Setup & Onboarding7273If Syke is not installed or configured, guide setup first.7475For humans at a terminal:76771. Install: `pipx install syke` (or `uv tool install syke`)782. Run: `syke setup`793. Follow the interactive provider, source, and daemon prompts.804. Confirm with `syke doctor`.8182For unattended agents, installers, and CI:83841. Run `syke setup --agent`.852. Parse the JSON `status`, `next_steps`, and `exit_code` fields.863. If `status` is `"needs_runtime"`, install Node.js 20+ (22 LTS recommended)87 and rerun `syke setup --agent`.884. If `status` is `"needs_provider"`, configure provider auth with89 `syke auth set <provider> --api-key <API_KEY> --use` or90 `syke auth login <provider> --use`, then rerun `syke setup --agent`.915. If `status` is `"complete"`, stop setup work and follow the returned92 `next_steps`. Do not loop on setup.936. If `status` is `"failed"`, read the `error` field and fix that issue.9495Common providers: `anthropic`, `openai`, `azure-openai-responses`, `kimi-coding`, `openrouter`.96For Azure, also pass `--base-url https://<resource>.openai.azure.com/openai/v1` and `--model <model>`.9798## Provider Commands99100| Command | What It Does |101|---------|-------------|102| `syke auth status` | Show selected provider, auth source, model, and endpoint |103| `syke auth use <name>` | Switch active provider |104| `syke auth set <name> --api-key <KEY> --use` | Store credentials and make this the active provider |105| `syke config show` | Show effective config |106107Provider resolution: CLI `--provider` flag > `SYKE_PROVIDER` env > Pi `defaultProvider` in `~/.syke/pi-agent/settings.json`.