syke

Category: Tools & Productivity | Uploader: saxenauts | Downloads: 0 | Version: v1.0（Latest）

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.

Changelog: Source: GitHub https://github.com/saxenauts/syke

Directory Structure

Current level: tree/main/

📁 .github/
- 📁 workflows/
  - 📄 _tests.yml 621 B
  - 📄 ci.yml 1.6 KB
  - 📄 publish.yml 2.0 KB
📁 docs/
- 📄 architecture-dark.svg 3.5 KB
- 📄 architecture-light.svg 3.5 KB
- 📄 ARCHITECTURE.md 31.5 KB
- 📄 CONFIG_REFERENCE.md 5.4 KB
- 📄 CURRENT_STATE.md 2.1 KB
- 📄 MEMEX_EVOLUTION.md 20.2 KB
- 📄 MEMEX_UPDATE_2.md 14.5 KB
- 📄 PROVIDERS.md 4.5 KB
- 📄 README.md 1.7 KB
- 📄 RELEASE_READINESS.md 4.2 KB
- 📄 RUNTIME_AND_REPLAY.md 1.5 KB
- 📄 SETUP.md 6.0 KB
📁 examples/
- 📄 quick_start.sh 267 B
📁 scripts/
- 📄 check_release_tag.py 1.3 KB
- 📄 dev-reset.sh 2.6 KB
- 📄 docs-preview.sh 1.9 KB
- 📄 fresh-install-test.sh 1.9 KB
- 📄 README.md 1.6 KB
- 📄 release-preflight.sh 2.3 KB
- 📄 smoke-artifact-install.sh 2.6 KB
- 📄 smoke-tool-install.sh 3.3 KB
- 📄 test-and-monitor.sh 2.9 KB
📁 syke/
- 📁 cli_commands/
  - 📄 __init__.py 51 B
  - 📄 ask.py 10.3 KB
  - 📄 auth.py 11.5 KB
  - 📄 config.py 7.3 KB
  - 📄 daemon.py 16.0 KB
  - 📄 maintenance.py 9.5 KB
  - 📄 record.py 3.1 KB
  - 📄 setup.py 17.9 KB
  - 📄 status.py 8.0 KB
- 📁 cli_support/
  - 📄 __init__.py 40 B
  - 📄 ask_output.py 2.6 KB
  - 📄 auth_flow.py 18.7 KB
  - 📄 context.py 500 B
  - 📄 daemon_state.py 3.7 KB
  - 📄 dashboard.py 2.2 KB
  - 📄 doctor.py 13.1 KB
  - 📄 exit_codes.py 1.2 KB
  - 📄 installers.py 5.2 KB
  - 📄 providers.py 5.2 KB
  - 📄 render.py 6.5 KB
  - 📄 setup_support.py 16.6 KB
- 📁 daemon/
  - 📄 __init__.py 201 B
  - 📄 ask_slots.py 6.0 KB
  - 📄 daemon.py 37.3 KB
  - 📄 ipc.py 19.5 KB
  - 📄 metrics.py 3.7 KB
- 📁 distribution/
  - 📄 __init__.py 2.0 KB
  - 📄 context_files.py 9.1 KB
- 📁 llm/
  - 📁 backends/
    
    📁 skills/
    
    📄 pi_synthesis.md 737 B
    
    📄 __init__.py 297 B
    
    📄 pi_ask.py 16.9 KB
    
    📄 pi_synthesis.py 48.4 KB
  - 📄 __init__.py 288 B
  - 📄 env.py 6.3 KB
  - 📄 pi_client.py 67.1 KB
  - 📄 pi_runtime.py 5.1 KB
  - 📄 simple.py 3.9 KB
- 📁 memory/
  - 📄 __init__.py 58 B
  - 📄 memex.py 3.1 KB
- 📁 observe/
  - 📁 seeds/
    
    📄 __init__.py 357 B
    
    📄 adapter-antigravity.md 4.8 KB
    
    📄 adapter-claude-code.md 6.1 KB
    
    📄 adapter-codex.md 6.6 KB
    
    📄 adapter-copilot.md 5.9 KB
    
    📄 adapter-cursor.md 6.2 KB
    
    📄 adapter-gemini-cli.md 7.1 KB
    
    📄 adapter-hermes.md 8.0 KB
    
    📄 adapter-opencode.md 6.7 KB
  - 📄 __init__.py 355 B
  - 📄 bootstrap.py 1.6 KB
  - 📄 catalog.py 8.0 KB
  - 📄 content_filter.py 4.0 KB
  - 📄 registry.py 3.7 KB
  - 📄 trace.py 284 B
- 📁 runtime/
  - 📄 __init__.py 3.6 KB
  - 📄 locator.py 11.1 KB
  - 📄 pi_settings.py 1.7 KB
  - 📄 psyche_md.py 9.6 KB
  - 📄 sandbox.py 10.4 KB
  - 📄 workspace.py 1.8 KB
- 📄 __init__.py 70 B
- 📄 __main__.py 105 B
- 📄 config.py 4.0 KB
- 📄 config_file.py 8.1 KB
- 📄 db.py 37.6 KB
- 📄 entrypoint.py 4.0 KB
- 📄 health.py 22.0 KB
- 📄 metrics.py 15.7 KB
- 📄 models.py 2.1 KB
- 📄 pi_state.py 11.9 KB
- 📄 py.typed 0 B
- 📄 source_selection.py 2.4 KB
- 📄 time.py 4.2 KB
- 📄 trace_store.py 5.5 KB
- 📄 version_check.py 2.9 KB
📁 tests/
- 📁 integration/
  - 📄 __init__.py 0 B
  - 📄 test_cli_real_flow.py 1.5 KB
- 📄 __init__.py 0 B
- 📄 conftest.py 5.8 KB
- 📄 observe_artifact_helpers.py 25.8 KB
- 📄 pi_rpc_raw.py 8.8 KB
- 📄 test_ask_slots.py 5.2 KB
- 📄 test_auth_flow.py 6.1 KB
- 📄 test_azure_gpt5_thinking.py 232 B
- 📄 test_build_prompt.py 7.4 KB
- 📄 test_cli_contract.py 33.1 KB
- 📄 test_config_file.py 4.4 KB
- 📄 test_core.py 7.1 KB
- 📄 test_daemon.py 24.8 KB
- 📄 test_daemon_controls.py 11.4 KB
- 📄 test_daemon_ipc.py 10.4 KB
- 📄 test_daemon_metrics.py 2.3 KB
- 📄 test_daemon_state.py 1.5 KB
- 📄 test_distribution.py 5.6 KB
- 📄 test_doctor_payload.py 2.7 KB
- 📄 test_health.py 283 B
- 📄 test_health_visibility.py 3.6 KB
- 📄 test_initialize_workspace.py 1.6 KB
- 📄 test_install_surface.py 2.2 KB
- 📄 test_installers.py 14.5 KB
- 📄 test_llm.py 13.9 KB
- 📄 test_metrics.py 416 B
- 📄 test_observe_registry.py 935 B
- 📄 test_persistence.py 11.7 KB
- 📄 test_pi_ask_trace_capture.py 5.8 KB
- 📄 test_pi_client.py 46.8 KB
- 📄 test_pi_integration.py 3.4 KB
- 📄 test_pi_native_cli.py 46.0 KB
- 📄 test_pi_state.py 8.9 KB
- 📄 test_pi_synthesis_contract.py 19.8 KB
- 📄 test_runtime_locator.py 6.3 KB
- 📄 test_runtime_parity.py 7.5 KB
- 📄 test_sandbox.py 6.1 KB
- 📄 test_sdist_surface.py 1.4 KB
- 📄 test_security.py 4.0 KB
- 📄 test_single_store_contract.py 822 B
- 📄 test_source_selection.py 2.0 KB
- 📄 test_trace_store.py 1.7 KB
- 📄 test_version_check.py 5.0 KB
📄 .env.example 1.2 KB
📄 .gitignore 1.6 KB
📄 CHANGELOG.md 44.6 KB
📄 LICENSE 33.7 KB
📄 MANIFEST.in 278 B
📄 PLATFORMS.md 2.2 KB
📄 pyproject.toml 2.5 KB
📄 README.md 9.8 KB
📄 setup.py 480 B
📄 SKILL.md 4.3 KB
📄 uv.lock 107.1 KB

SKILL.md

---
name: syke
description: "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."
version: 0.5.2
author: saxenauts
license: AGPL-3.0-only
metadata:
  hermes:
    tags: [Memory, Context, Identity, Cross-Platform, Agentic-Memory]
    related_skills: []
    requires_toolsets: [terminal]
  requires:
    bins: ["syke"]
  install:
    - id: pipx
      kind: pipx
      package: syke
      bins: ["syke"]
      label: "Install Syke (pipx)"
---

# 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

1. Read the memex already in context or call `syke memex`.
   If you need the file directly, start with `~/.syke/MEMEX.md`.
2. Use `syke ask` when the memex is not enough.
3. Use `syke record` after useful work so the next session inherits it.
4. Use `syke status` for a quick state check.
5. 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, follow this exact sequence:

1. Install: `pipx install syke` (or `uv tool install syke`)
2. Run: `syke setup --agent`
   - This returns JSON. Read the `status` field.
   - If `status` is `"needs_runtime"`: install Node.js 18+ and rerun `syke setup --agent`.
   - If `status` is `"needs_provider"`: the user needs to provide an LLM API key.
     Run `syke auth set <provider> --api-key <API_KEY> --use` with the user's chosen provider
     and key, then run `syke setup --agent` again.
   - If `status` is `"complete"`: setup is done. Background ingestion and synthesis
     are running. The user can start using `syke ask` and `syke record` immediately.
   - If `status` is `"failed"`: read the `error` field and fix the issue.
3. Do NOT run `syke setup` without `--agent` — that launches an interactive menu
   that requires a human at a terminal.
4. After setup, confirm health with `syke doctor`.

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`.

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

syke

Directory Structure

SKILL.md

Report

Notice