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 context`, and `syke record` for continuity across sessions.

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

Directory Structure

Current level: tree/main/

📁 .github/
- 📁 ISSUE_TEMPLATE/
  - 📄 bug_report.md 439 B
  - 📄 feature_request.md 222 B
- 📁 workflows/
  - 📄 _tests.yml 562 B
  - 📄 ci.yml 1.4 KB
  - 📄 publish.yml 1.9 KB
- 📄 pull_request_template.md 710 B
📁 docs/
- 📁 guide/
  - 📄 agent-setup.md 2.5 KB
- 📄 architecture-dark.svg 3.5 KB
- 📄 architecture-light.svg 3.5 KB
- 📄 ARCHITECTURE.md 32.2 KB
- 📄 CLI_UX_SPEC.md 12.4 KB
- 📄 CONFIG_REFERENCE.md 5.0 KB
- 📄 CURRENT_STATE.md 12.5 KB
- 📄 MEMEX_EVOLUTION.md 20.2 KB
- 📄 MEMEX_IN_USE.md 7.7 KB
- 📄 PROVIDERS.md 4.5 KB
- 📄 README.md 1.1 KB
- 📄 RUNTIME_AND_REPLAY.md 12.9 KB
- 📄 SETUP.md 10.4 KB
- 📄 TESTING.md 2.5 KB
📁 examples/
- 📄 quick_start.sh 464 B
📁 scripts/
- 📄 check_release_tag.py 1.3 KB
- 📄 dev-reset.sh 2.6 KB
- 📄 fresh-install-test.sh 1.9 KB
- 📄 release-preflight.sh 2.0 KB
- 📄 smoke-artifact-install.sh 2.6 KB
- 📄 smoke-tool-install.sh 3.3 KB
- 📄 test-and-monitor.sh 2.9 KB
📁 strategies/
- 📁 ingest/
  - 📄 chatgpt-export.md 1.5 KB
  - 📄 claude-code.md 2.8 KB
  - 📄 github-api.md 1.3 KB
📁 syke/
- 📁 cli_commands/
  - 📄 __init__.py 51 B
  - 📄 ask.py 9.0 KB
  - 📄 auth.py 11.4 KB
  - 📄 config.py 7.4 KB
  - 📄 daemon.py 14.8 KB
  - 📄 maintenance.py 10.1 KB
  - 📄 record.py 5.2 KB
  - 📄 setup.py 17.4 KB
  - 📄 status.py 9.0 KB
- 📁 cli_support/
  - 📄 __init__.py 40 B
  - 📄 ask_output.py 2.6 KB
  - 📄 auth_flow.py 18.6 KB
  - 📄 context.py 561 B
  - 📄 daemon_state.py 3.4 KB
  - 📄 dashboard.py 2.2 KB
  - 📄 doctor.py 12.7 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
  - 📄 daemon.py 40.7 KB
  - 📄 ipc.py 18.2 KB
  - 📄 metrics.py 12.1 KB
- 📁 distribution/
  - 📄 __init__.py 2.0 KB
  - 📄 context_files.py 10.4 KB
- 📁 llm/
  - 📁 backends/
    
    📁 skills/
    
    📄 pi_synthesis.md 3.7 KB
    
    📄 pi_synthesis_bootstrap.md 743 B
    
    📄 __init__.py 297 B
    
    📄 pi_ask.py 22.5 KB
    
    📄 pi_synthesis.py 41.8 KB
  - 📄 __init__.py 288 B
  - 📄 env.py 6.3 KB
  - 📄 pi_client.py 55.3 KB
  - 📄 pi_runtime.py 4.1 KB
  - 📄 simple.py 4.0 KB
- 📁 memory/
  - 📄 __init__.py 58 B
  - 📄 memex.py 2.2 KB
- 📁 observe/
  - 📁 seeds/
    
    📄 __init__.py 265 B
    
    📄 antigravity.py 18.1 KB
    
    📄 claude-code.py 19.3 KB
    
    📄 codex.py 34.6 KB
    
    📄 copilot.py 26.5 KB
    
    📄 cursor.py 15.7 KB
    
    📄 gemini-cli.py 30.2 KB
    
    📄 hermes.py 34.6 KB
    
    📄 opencode.py 23.8 KB
  - 📁 skills/
    
    📄 factory.md 3.8 KB
  - 📄 __init__.py 474 B
  - 📄 adapter.py 18.9 KB
  - 📄 bootstrap.py 3.4 KB
  - 📄 catalog.py 8.0 KB
  - 📄 content_filter.py 4.0 KB
  - 📄 factory.py 6.0 KB
  - 📄 importers.py 5.1 KB
  - 📄 parsers.py 7.4 KB
  - 📄 registry.py 5.6 KB
  - 📄 runtime.py 35.9 KB
  - 📄 trace.py 5.1 KB
  - 📄 validator.py 9.6 KB
- 📁 runtime/
  - 📄 __init__.py 2.8 KB
  - 📄 agents_md.py 948 B
  - 📄 locator.py 11.1 KB
  - 📄 pi_settings.py 1.4 KB
  - 📄 sandbox.py 2.6 KB
  - 📄 workspace.py 20.4 KB
- 📄 __init__.py 70 B
- 📄 __main__.py 105 B
- 📄 config.py 4.7 KB
- 📄 config_file.py 8.0 KB
- 📄 db.py 51.3 KB
- 📄 entrypoint.py 4.0 KB
- 📄 health.py 25.9 KB
- 📄 metrics.py 14.6 KB
- 📄 models.py 4.4 KB
- 📄 pi_state.py 9.6 KB
- 📄 sync.py 5.4 KB
- 📄 time.py 4.2 KB
- 📄 version_check.py 2.9 KB
📁 tests/
- 📁 integration/
  - 📄 __init__.py 0 B
- 📄 __init__.py 0 B
- 📄 conftest.py 5.9 KB
- 📄 observe_artifact_helpers.py 25.8 KB
- 📄 pi_rpc_raw.py 8.8 KB
- 📄 test_azure_gpt5_thinking.py 232 B
- 📄 test_cli_contract.py 25.2 KB
- 📄 test_config_file.py 4.4 KB
- 📄 test_core.py 7.8 KB
- 📄 test_daemon.py 28.5 KB
- 📄 test_daemon_controls.py 8.7 KB
- 📄 test_daemon_ipc.py 7.7 KB
- 📄 test_db.py 947 B
- 📄 test_distribution.py 5.5 KB
- 📄 test_dual_store_contract.py 3.8 KB
- 📄 test_factory.py 11.9 KB
- 📄 test_health.py 626 B
- 📄 test_health_visibility.py 2.7 KB
- 📄 test_install_surface.py 2.2 KB
- 📄 test_llm.py 14.3 KB
- 📄 test_observe.py 17.9 KB
- 📄 test_observe_artifact_ingest.py 5.6 KB
- 📄 test_parsers.py 6.0 KB
- 📄 test_persistence.py 13.1 KB
- 📄 test_pi_client.py 36.9 KB
- 📄 test_pi_integration.py 1.8 KB
- 📄 test_pi_native_cli.py 42.0 KB
- 📄 test_pi_state.py 6.7 KB
- 📄 test_pi_synthesis_contract.py 10.4 KB
- 📄 test_runtime_locator.py 6.3 KB
- 📄 test_runtime_parity.py 8.0 KB
- 📄 test_runtime_workspace.py 15.0 KB
- 📄 test_security.py 4.0 KB
- 📄 test_self_observation.py 19.1 KB
- 📄 test_sense_hooks.py 1.9 KB
- 📄 test_sense_sqlite_watcher.py 10.5 KB
- 📄 test_sense_tailer.py 1.8 KB
- 📄 test_sense_writer.py 2.1 KB
📄 .env.example 1.2 KB
📄 .gitignore 1.0 KB
📄 CHANGELOG.md 36.1 KB
📄 CONTRIBUTING.md 3.4 KB
📄 LICENSE 33.7 KB
📄 PLATFORMS.md 2.1 KB
📄 pyproject.toml 2.5 KB
📄 README.md 11.2 KB
📄 SECURITY.md 4.5 KB
📄 setup.py 480 B
📄 SKILL.md 4.2 KB
📄 uv.lock 112.4 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 context`, and `syke record` for continuity across sessions."
version: 0.5.1
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/data/{user}/MEMEX.md`

## When to Use

- **`syke ask`**: deeper timeline and evidence-backed queries
- **`syke context`**: 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 context` | 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 context`.
   If you need the file directly, start with `~/.syke/data/{user}/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 context`.
- If `syke ask` is killed by a caller timeout, fall back to `syke context`.
- Some sandboxes can read the memex but cannot open the live store. In those cases, use `syke context` 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_provider"`: the user needs to provide an LLM API key.
     Run `syke auth set <provider> <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.

No comments yet. Be the first one!

syke

Directory Structure

SKILL.md

Report

Notice