8000 Configurable memory-loop model + non-interactive install command, so Deck can wire up tier-3 agent memory · Issue #11 · simon-inkie/inkie-the-brain · GitHub
[go: up one dir, main page]

Skip to content

Configurable memory-loop model + non-interactive install command, so Deck can wire up tier-3 agent memory #11

Closed

Description

@simon-inkie

Problem

This is the memory-layer half of a two-repo fix. Deck (a multi-agent runner) wants to wire every tier-3 agent up to this repo's memory loop, semantic search and watcher daemon during its own install. Three things in this repo currently block that:

  • The memory loop's model CLI and model id are hardcoded rather than configurable, and the README/QUICKSTART say an unrelated API key is required for "the observation LLM", which the code contradicts.
  • There is no non-interactive, idempotent install command: today's setup clones/builds and merges hooks by hand, and agent init <name> is interactive.
  • The setup helper and systemd units assume a fixed checkout path/name, so a differently-named clone (as a dependency inside another project's install) does not match.

Evidence

Found while reading this repo as part of a Windows/WSL install test of a downstream multi-agent tool (Deck):

  • observe.sh, reflect.sh and compress-era.sh shell out to a specific hardcoded model CLI invocation. The README and QUICKSTART say a paid embeddings key is required for "the observation LLM", which the code contradicts — the memory loop itself costs only the model CLI a host already has; only semantic search (M2) needs the paid key.
  • The setup helper expects the checkout at a fixed path and greps settings for a matching build path; a differently-named clone does not match. The systemd units make the same path assumption.
  • The daemon's pnpm watch starts an additional watcher unconditionally that a downstream install would want to make opt-in.

Proposed fix

  • Make the memory loop's model CLI and model id configuration (env or config file), defaulting to current behaviour.
  • Correct the README/QUICKSTART on which key the loop actually needs (model CLI only) versus what semantic search needs (the paid embeddings key).
  • Provide a non-interactive, idempotent install command that clones/builds and merges the three hooks (UserPromptSubmit, Stop, PreCompact auto + manual) into a given settings.json without clobbering existing hooks.
  • Make agent init <name> scriptable: no prompts, idempotent, meaningful exit codes.
  • Keep QUICKSTART steps that cover semantic search current; confirm the dry-run mode covers a keyless verification.
  • Ship systemd user units that take the checkout path as a parameter rather than assuming a fixed path; make the extra watcher opt-in.
  • Ship a runtime-neutral "recall and write memory" instruction (when to search before rebuilding, how to call the search tool, where durable notes go) as a template, not only as a Claude Code skill; fix the setup helper's hardcoded path.

Acceptance criteria

  • A downstream install can run the new install command non-interactively against a differently-named checkout and end up with working hooks and a seeded silo.
  • README/QUICKSTART correctly state that the memory loop itself needs only the model CLI, and that a paid key is only needed for semantic search.
  • agent init <name> runs with no prompts and a stable exit code, scriptable from another project's install script.
  • Existing tests/self-checks in this repo still pass with the model CLI and id set from configuration rather than hardcoded.

From the 2026-09-27 Windows/WSL install test.


Deck-side companion issue: simon-inkie/inkie-deck#21

Activity

  1. simon-inkie commented on Sep 27, 2026

    @simon-inkie
    OwnerAuthor

    Scope addition (maintainer decision, 2026-09-27): make the embedding provider a config seam rather than a hardcoded constant. The Google API key stays the default, and the Deck install guides the key setup. Other providers, including a local model as a free offline fallback, should be addable without code changes. The memory loop tier needs no embedding key at all. The docs should say that clearly, because at the moment they imply Gemini is required for everything.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    installInstall / setup flowpriority:P1Blocks a normal user

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions

      0