Files
oh-my-pi/packages/coding-agent
Dan Greco 9bb96b22e7 fix(bash): scope shell snapshots per uid so shared-/tmp accounts don't EACCES
- The snapshot dir was one fixed name under the shared `os.tmpdir()`,
  created 0700 because the script inlines env-var values referenced by
  captured functions (#3470). The first account to run omp owns it, so on
  a box where a second Unix account runs omp every bash tool call died
  with `EACCES: permission denied, open
  '/tmp/omp-shell-snapshots/snapshot-bash-<uuid>.sh'`.
- `recursive: true` swallows EEXIST and `mode` is ignored for an existing
  dir, and the defensive `chmodSync` fails EPERM on a foreign-owned dir
  and was already swallowed, so the code walked straight into a dir it
  could not write.
- `mkdirSync` and the pre-create `writeFileSync` both sat outside any
  try/catch, so the error escaped `getOrCreateSnapshot` into
  `executeBash`. Nothing is cached on failure, so it repeated for every
  command instead of degrading once.
- Scope the dir per uid (`omp-shell-snapshots-<uid>`) and guard both
  filesystem calls: an unusable dir now logs at debug and returns `null`,
  which callers already handle as "run without a snapshot".
2026-07-30 22:54:33 -04:00
..
2026-07-30 17:27:05 +02:00

@oh-my-pi/pi-coding-agent

Core implementation package for the omp coding agent in the oh-my-pi monorepo.

For installation, setup, provider configuration, model roles, slash commands, and full CLI reference, see:

Package-specific references:

Memory backends

The agent supports three mutually-exclusive memory backends, selected via the memory.backend setting (Settings → Memory tab, or ~/.omp/config.yml):

  • off (default) — no memory subsystem runs.
  • local — existing rollout-summarisation pipeline; writes memory_summary.md and consolidated artifacts under the agent dir.
  • hindsight — talks to a Hindsight server (Cloud or self-hosted Docker), retains transcripts every Nth user turn, recalls memories on the first turn of a session, and exposes retain, recall, and reflect.

Hindsight quickstart

  1. Run a Hindsight server (Cloud or docker run -p 8888:8888 ghcr.io/vectorize-io/hindsight:latest).
  2. Set memory.backend = "hindsight" and hindsight.apiUrl = "http://localhost:8888" (or your Cloud URL).
  3. Optional environment overrides (env wins over settings):
    • HINDSIGHT_API_URL, HINDSIGHT_API_TOKEN — connection
    • HINDSIGHT_BANK_ID, HINDSIGHT_DYNAMIC_BANK_ID, HINDSIGHT_AGENT_NAME — bank addressing
    • HINDSIGHT_AUTO_RECALL, HINDSIGHT_AUTO_RETAIN, HINDSIGHT_RETAIN_MODE — lifecycle
    • HINDSIGHT_RECALL_BUDGET, HINDSIGHT_RECALL_MAX_TOKENS — recall sizing
    • HINDSIGHT_BANK_MISSION, HINDSIGHT_DEBUG

Switching backends mid-session immediately replaces the live backend, memory tools, listeners, and system-prompt context. Existing users with memories.enabled = true|false are migrated to memory.backend = "local"|"off" exactly once on first launch; afterward, memory.backend is the sole runtime selector.