Back to directory

sivtr

Maintenance: Active

ariestar/sivtr

A unified memory workspace for agents and people, making terminal output and AI session context searchable and reusable across local workspaces.

View on GitHubHomepage
$ curl -fsSL https://raw.githubusercontent.com/Ariestar/sivtr/main/install.sh | sh

264

stars

18

forks

Rust

Language

Apache-2.0

License

2026-04-20

Created

2026-09-08

Last push

Apache-2.0 Rust CLI giving agents and humans one searchable memory over terminal output and AI sessions — including local Dsh sessions — connected via MCP tools and shell hooks.

DSH integration

Compatible

Author-claimed

Safety audit

Unaudited

Last verified

2026-08-21

License

Apache-2.0

01What can it help you accomplish?

  • Give DeepSeek Harness (Dsh) workflows a searchable agent memory over terminal output and AI sessions

    Searchable WorkRecords — local Dsh sessions, terminal commands with stdout/stderr, exit codes and durations — reachable by agents via sivtr_search / sivtr_show / sivtr_zoom / sivtr_filter / sivtr_status

    Developers running Dsh and other coding agents who want the agent to recall local evidence instead of re-pasting logs

  • Let the agent fix recent failures and resume interrupted work without pasting logs

    Agent-driven fixes and resumable context based on exact local records, addressed to every hit via stable refs (show / zoom / filter)

    Developers whose agents repeatedly rebuild already-existing context from terminal errors, test output and previous AI sessions

02How to install into DeepSeek Harness

Prerequisites

  • A supported shell: Bash, Zsh, PowerShell or Nushell (shell hooks capture command output)
  • No Rust toolchain required for the prebuilt CLI (`cargo binstall sivtr` or the install script); Rust is only needed for `cargo install sivtr` from source
  • Node/npx only if you add the optional sivtr-memory skill (`npx skills add Ariestar/sivtr --skill sivtr-memory -g`)

Installation steps

  1. 01

    Install the CLI: `cargo binstall sivtr` (prebuilt), or `curl -fsSL https://raw.githubusercontent.com/Ariestar/sivtr/main/install.sh | sh` on Linux/macOS/WSL, or `irm https://raw.githubusercontent.com/Ariestar/sivtr/main/install.ps1 | iex` on Windows PowerShell

    $ curl -fsSL https://raw.githubusercontent.com/Ariestar/sivtr/main/install.sh | sh

  2. 02

    Run `sivtr setup` for one-shot configuration (env detection + shell hooks + MCP host + sivtr-memory skill + smoke check), or stepwise: `sivtr init bash|zsh|powershell|nushell`, `sivtr mcp install`, `npx skills add Ariestar/sivtr --skill sivtr-memory -g -y`

    $ npx skills add Ariestar/sivtr --skill sivtr-memory -g -y

  3. 03

    Use `sivtr mcp install -p <hosts>` to register MCP with specific hosts; Dsh is one of the supported local sources whose agent sessions become searchable

Verify the integration

  • Run `sivtr doctor` to diagnose and auto-fix binary/config/hooks/providers; `sivtr setup` itself ends with a smoke check

03DSH integration and capability boundaries

DSH integrationCompatible

MCP-first agent memory CLI: register MCP tools for agent hosts via `sivtr mcp install`, and index local Dsh (DeepSeek Harness) agent sessions as searchable memory

  • MCP-first agent memory

    local terminal output + all registered agent provider sessions (incl. Dsh)agent-callable tools sivtr_search / sivtr_show / sivtr_zoom / sivtr_filter / sivtr_status

    modifies agent host configuration to register the MCP server (`sivtr mcp install`)
  • Shell history with output capture

    commands run in Bash, Zsh, PowerShell or Nushellrecords of command, stdout/stderr, exit code, directory and duration

    installs hooks into your shell profile to capture command output (on Windows the hook is written only into the PowerShell profile, no registry changes)
  • Named memory variables & TUI search

    search results and command outputssaved variables like @last / @failures usable in pipelines (`@`, `@failures[1,3..5]`), plus search/show/filter/nav CLI and a TUI workspace browser

  • Cross-device sharing & groups

    local workspacesread-only shares browsed via `desk:...` refs; multi-device groups with automatic sync

    data leaves the machine during share/group sync (opt-in, read-only, common secrets redacted by default); an iroh daemon is started automatically when needed

04Who is it for? When not to use it?

Good for

  • Developers running Dsh and other coding agents who want the agent to recall local evidence instead of re-pasting logs
  • Developers whose agents repeatedly rebuild already-existing context from terminal errors, test output and previous AI sessions

05Compatibility, maintenance and safety notes

  • On Windows, `sivtr init powershell` may report that the profile is not loaded; you need to run `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` once to raise the current user's execution policy. The hook is written only into the PowerShell profile — no registry changes.
  • Memory is local-first, but cross-device sharing and group sync send data off-machine over encrypted iroh (opt-in, read-only, with common secrets redacted before leaving the machine), and a daemon starts automatically when needed.
  • `sivtr setup` / `sivtr init` modify your shell configuration by installing hooks into your shell profile so command output can be captured; `sivtr doctor --fix` is provided to diagnose and repair hooks.
2026-04-202026-08-19v0.5.1

Apache-2.0 · actively maintained (latest release v0.5.1, 2026-08-18)

06Frequently asked questions

How does sivtr integrate with DeepSeek Harness (Dsh)?

Dsh is one of sivtr's supported sources: local Dsh agent sessions are indexed and become searchable alongside terminal output and sessions from other agents. For agent workflows, register MCP with `sivtr mcp install` and optionally add the bundled sivtr-memory skill.

Is it a native dsh plugin or MCP?

MCP-first: after `sivtr mcp install`, agents call sivtr_search / sivtr_show / sivtr_zoom / sivtr_filter / sivtr_status directly. Humans can also use the CLI and TUI workspace browser at any time.

What do I need before installing?

Just a supported shell. `cargo binstall sivtr` or the install script installs a prebuilt binary with no Rust toolchain required; Node/npx is only needed for the optional sivtr-memory skill.

Where does my data go?

Memory stays in a local workspace. Cross-device sharing is opt-in and read-only, redacts common secrets before data leaves the machine, and transports over encrypted iroh with an auto-started daemon.

Any known limitations?

On Windows, `sivtr init powershell` may require running `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` once. Shell hooks are written into your shell profile (no registry changes), and `sivtr doctor --fix` repairs broken setups.

08Data and sources

  • Author-claimedgithub.com6e90a451ed6b…

    | Dsh | 本地 Dsh agent sessions. |

  • Author-claimedgithub.com6e90a451ed6b…

    **一个搜索面覆盖本地工作**:终端输出 + 所有已注册 Agent provider(Codex / Claude Code / Cursor / Dsh / Gemini / Goose / Hermes / OpenCode / Op…

  • Author-claimedgithub.com6e90a451ed6b…

    Agent 工作流建议安装 `sivtr` CLI,用 `sivtr mcp install` 注册 MCP,并可选用内置 `sivtr-memory` skill。

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-21. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.