feat(cli): add project memory integration

[johnnyeric]

Issue

No linked issue. Follow-up CLI integration PR stacked on #11355.

Context

#11355 adds the core project memory package. This PR wires that package into the CLI so project memory is available from the TUI, agent prompts, server API, SDK, and Kilo-specific tools.

The goal is to keep the reusable memory implementation in the base PR while making the CLI consume it through Kilo-owned integration points where possible.

Implementation

• Registers memory services in the CLI runtime and exposes project-memory operations through Kilo HTTP API handlers.
• Adds TUI memory surfaces, including memory commands, sidebar/meta display, capture events, and a dialog for memory review/interaction.
• Adds memory_save and memory_recall tools plus prompt/tool-registry integration so agents can persist and retrieve project context.
• Threads memory context into session prompt construction and system prompt behavior, while keeping most new code under packages/opencode/src/kilocode/.
• Regenerates SDK/OpenAPI output for the new memory endpoints.
• Adds focused CLI tests for memory capture, core flows, commands, HTTP API behavior, and memory tools.
• Includes a patch changeset for user-facing CLI memory support.

Reviewer attention

• this PR intentionally has small shared-file touch points for runtime registration, session prompt integration, server route wiring, and tool registry wiring.
• Most behavior is isolated in Kilo-owned paths to reduce upstream merge friction.
• Large part of the change diff is from generated files
• I opted for keeping the kilo-memory package lightweight and effect free, and added an "adapter" layer in kilocode path for memory with effect

Screenshots / Video

How to Test

Manual/local verification

Agent verification performed:

• git push -u origin johnnyeric/memory-cli-integration ran the pre-push hook.
• Pre-push hook executed bun turbo typecheck successfully across the workspace.

Reviewer test steps

1. Check out this branch with feat: add core project memory package #11355 as the base branch.
2. From packages/opencode/, run the focused memory tests, for example bun test ./test/kilocode/memory/memory-core.test.ts ./test/kilocode/memory/memory-capture.test.ts ./test/kilocode/memory/memory-save-tool.test.ts ./test/kilocode/memory/memory-recall-tool.test.ts ./test/kilocode/server/httpapi-memory.test.ts.
3. Start the CLI TUI and verify the memory command/dialog can open from a project session.
4. Exercise an agent turn that saves a project memory, then verify a later turn can recall that memory through the memory tools/context.
5. If reviewing API behavior, run the local backend and inspect the new memory endpoints exposed through the regenerated SDK/OpenAPI output.

Checklist

• Issue linked above, or exception explained
• Tests/verification described
• Screenshots/video included for visual changes, or marked N/A
• Changeset considered for user-facing changes
• I personally reviewed the diff and can explain the changes, including any AI-assisted work.

Depends on #11355.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b97010a604

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[kilo-code-bot]

Code Review Summary

Status: 2 Issues Found | Recommendation: Address before merge

Overview

Severity	Count
CRITICAL	0
WARNING	2
SUGGESTION	0

Issue Details (click to expand)

No new issues in the incremental diff since 9713ad96bd7d9a9c74bbb893d0ecb42dec1bb4b9.

Other Observations (not in diff)

Issues found in unchanged code that cannot receive inline comments:

File	Line	Issue
packages/kilo-memory/src/capture/redact.ts	48	Bare user@host URLs now trip the secret detector, so harmless clone/remote URLs can no longer be saved into memory.
packages/kilo-memory/src/recall/budget.ts	60	The truncation note tells agents to use mode=typed, which cannot recover omitted session digests from a truncated startup index.

Files Reviewed (1 file)

• packages/opencode/src/cli/cmd/tui/routes/session/permission.tsx

Fix these issues in Kilo Cloud

Previous Review Summaries (4 snapshots, latest commit 9713ad9)

Current summary above is authoritative. Previous snapshots are kept for context only.

Previous review (commit 9713ad9)

Status: 2 Issues Found | Recommendation: Address before merge

Overview

Severity	Count
CRITICAL	0
WARNING	2
SUGGESTION	0

Issue Details (click to expand)

WARNING

File	Line	Issue
packages/kilo-memory/src/capture/redact.ts	48	Bare user@host URLs now trip the secret detector, so harmless clone/remote URLs can no longer be saved into memory.
packages/kilo-memory/src/recall/budget.ts	60	The truncation note tells agents to use mode=typed, which cannot recover omitted session digests from a truncated startup index.

Other Observations (not in diff)

These warnings are in incremental-only packages/kilo-memory/ changes that are not present in gh pr diff for this stacked PR, so they could not receive inline comments without hitting GitHub's diff-line restriction.

Files Reviewed (24 files)

• packages/kilo-memory/src/capture/capture.ts
• packages/kilo-memory/src/capture/diff.ts
• packages/kilo-memory/src/capture/digest-text.ts
• packages/kilo-memory/src/capture/ops.ts
• packages/kilo-memory/src/capture/outcome.ts
• packages/kilo-memory/src/capture/parse.ts
• packages/kilo-memory/src/capture/plan.ts
• packages/kilo-memory/src/capture/redact.ts - 1 issue
• packages/kilo-memory/src/capture/reject.ts
• packages/kilo-memory/src/memory-notice.ts
• packages/kilo-memory/src/memory.ts
• packages/kilo-memory/src/recall/budget.ts - 1 issue
• packages/kilo-memory/src/recall/index-format.ts
• packages/kilo-memory/src/recall/indexer.ts
• packages/kilo-memory/src/recall/shared.ts
• packages/kilo-memory/src/storage/markdown.ts
• packages/kilo-memory/src/storage/sessions.ts
• packages/kilo-memory/src/storage/sources.ts
• packages/kilo-memory/src/storage/state.ts
• packages/kilo-memory/src/text.ts
• packages/kilo-memory/test/capture.test.ts
• packages/kilo-memory/test/core.test.ts
• packages/kilo-memory/test/markdown.test.ts
• packages/kilo-memory/test/text.test.ts

Fix these issues in Kilo Cloud

Previous review (commit e0a734e)

Status: 2 Issues Found | Recommendation: Address before merge

Overview

Severity	Count
CRITICAL	0
WARNING	2
SUGGESTION	0

Issue Details (click to expand)

WARNING

File	Line	Issue
packages/kilo-memory/src/capture/redact.ts	48	Bare user@host URLs now trip the secret detector, so harmless clone/remote URLs can no longer be saved into memory.
packages/kilo-memory/src/recall/budget.ts	60	The truncation note tells agents to use mode=typed, which cannot recover omitted session digests from a truncated startup index.

Other Observations (not in diff)

These warnings are in incremental-only packages/kilo-memory/ changes that are not present in gh pr diff for this stacked PR, so they could not receive inline comments without hitting GitHub's diff-line restriction.

Files Reviewed (24 files)

• packages/kilo-memory/src/capture/capture.ts
• packages/kilo-memory/src/capture/diff.ts
• packages/kilo-memory/src/capture/digest-text.ts
• packages/kilo-memory/src/capture/ops.ts
• packages/kilo-memory/src/capture/outcome.ts
• packages/kilo-memory/src/capture/parse.ts
• packages/kilo-memory/src/capture/plan.ts
• packages/kilo-memory/src/capture/redact.ts - 1 issue
• packages/kilo-memory/src/capture/reject.ts
• packages/kilo-memory/src/memory-notice.ts
• packages/kilo-memory/src/memory.ts
• packages/kilo-memory/src/recall/budget.ts - 1 issue
• packages/kilo-memory/src/recall/index-format.ts
• packages/kilo-memory/src/recall/indexer.ts
• packages/kilo-memory/src/recall/shared.ts
• packages/kilo-memory/src/storage/markdown.ts
• packages/kilo-memory/src/storage/sessions.ts
• packages/kilo-memory/src/storage/sources.ts
• packages/kilo-memory/src/storage/state.ts
• packages/kilo-memory/src/text.ts
• packages/kilo-memory/test/capture.test.ts
• packages/kilo-memory/test/core.test.ts
• packages/kilo-memory/test/markdown.test.ts
• packages/kilo-memory/test/text.test.ts

Fix these issues in Kilo Cloud

Previous review (commit 71882a3)

Status: 2 Issues Found | Recommendation: Address before merge

Overview

Severity	Count
CRITICAL	0
WARNING	2
SUGGESTION	0

Issue Details (click to expand)

WARNING

File	Line	Issue
packages/kilo-memory/src/capture/redact.ts	48	Bare user@host URLs now trip the secret detector, so harmless clone/remote URLs can no longer be saved into memory.
packages/kilo-memory/src/recall/budget.ts	60	The truncation note tells agents to use mode=typed, which cannot recover omitted session digests from a truncated startup index.

Other Observations (not in diff)

These warnings are in incremental-only packages/kilo-memory/ changes that are not present in gh pr diff for this stacked PR, so they could not receive inline comments without hitting GitHub's diff-line restriction.

Files Reviewed (24 files)

• packages/kilo-memory/src/capture/capture.ts
• packages/kilo-memory/src/capture/diff.ts
• packages/kilo-memory/src/capture/digest-text.ts
• packages/kilo-memory/src/capture/ops.ts
• packages/kilo-memory/src/capture/outcome.ts
• packages/kilo-memory/src/capture/parse.ts
• packages/kilo-memory/src/capture/plan.ts
• packages/kilo-memory/src/capture/redact.ts - 1 issue
• packages/kilo-memory/src/capture/reject.ts
• packages/kilo-memory/src/memory-notice.ts
• packages/kilo-memory/src/memory.ts
• packages/kilo-memory/src/recall/budget.ts - 1 issue
• packages/kilo-memory/src/recall/index-format.ts
• packages/kilo-memory/src/recall/indexer.ts
• packages/kilo-memory/src/recall/shared.ts
• packages/kilo-memory/src/storage/markdown.ts
• packages/kilo-memory/src/storage/sessions.ts
• packages/kilo-memory/src/storage/sources.ts
• packages/kilo-memory/src/storage/state.ts
• packages/kilo-memory/src/text.ts
• packages/kilo-memory/test/capture.test.ts
• packages/kilo-memory/test/core.test.ts
• packages/kilo-memory/test/markdown.test.ts
• packages/kilo-memory/test/text.test.ts

Fix these issues in Kilo Cloud

Previous review (commit 5ec40fc)

Status: No Issues Found | Recommendation: Merge

All three previously flagged issues have been resolved in commit 5ec40fc88b:

• Dead Effect.catch in system-prompt.ts — fixed by switching to Effect.tryPromise(() => …) overload
• Instance context loss in service.ts bridge — fixed with InstanceState.bind wrapper
• Permission rejection swallowing in memory-recall.ts — fixed with Effect.catchIf targeting only memory-domain errors
• Service wrapper bypass in session/prompt.ts — fixed by extending SystemPrompt.Service.environment and routing through it

Files Reviewed (62 files)

• .changeset/kilo-memory-cli.md
• packages/opencode/package.json
• packages/opencode/src/cli/cmd/tui/app.tsx
• packages/opencode/src/cli/cmd/tui/component/prompt/index.tsx
• packages/opencode/src/cli/cmd/tui/routes/session/index.tsx
• packages/opencode/src/cli/cmd/tui/routes/session/permission.tsx
• packages/opencode/src/cli/cmd/tui/routes/session/sidebar.tsx
• packages/opencode/src/config/config.ts
• packages/opencode/src/effect/app-runtime.ts
• packages/opencode/src/kilocode/agent/index.ts
• packages/opencode/src/kilocode/cli/cmd/tui/component/dialog-memory.tsx
• packages/opencode/src/kilocode/cli/cmd/tui/component/memory-sidebar.tsx
• packages/opencode/src/kilocode/cli/cmd/tui/memory-command.ts
• packages/opencode/src/kilocode/cli/cmd/tui/memory-events.ts
• packages/opencode/src/kilocode/cli/cmd/tui/memory-meta.ts
• packages/opencode/src/kilocode/memory/capture.ts
• packages/opencode/src/kilocode/memory/config.ts
• packages/opencode/src/kilocode/memory/errors.ts
• packages/opencode/src/kilocode/memory/events.ts
• packages/opencode/src/kilocode/memory/index.ts
• packages/opencode/src/kilocode/memory/paths.ts
• packages/opencode/src/kilocode/memory/service.ts
• packages/opencode/src/kilocode/memory/timers.ts
• packages/opencode/src/kilocode/memory/turn.ts
• packages/opencode/src/kilocode/plugins/home-footer.tsx
• packages/opencode/src/kilocode/server/httpapi/groups/memory.ts
• packages/opencode/src/kilocode/server/httpapi/handlers/memory.ts
• packages/opencode/src/kilocode/server/httpapi/server.ts
• packages/opencode/src/kilocode/session/prompt.ts
• packages/opencode/src/kilocode/skills/kilo-config.md
• packages/opencode/src/kilocode/system-prompt.ts
• packages/opencode/src/kilocode/tool/memory-recall.ts
• packages/opencode/src/kilocode/tool/memory-recall.txt
• packages/opencode/src/kilocode/tool/memory-save.ts
• packages/opencode/src/kilocode/tool/memory-save.txt
• packages/opencode/src/kilocode/tool/registry.ts
• packages/opencode/src/server/routes/instance/httpapi/api.ts
• packages/opencode/src/server/routes/instance/httpapi/server.ts
• packages/opencode/src/session/prompt.ts
• packages/opencode/src/session/system.ts
• packages/opencode/src/tool/registry.ts
• packages/opencode/test/config/config.test.ts
• packages/opencode/test/kilocode/config/config.test.ts
• packages/opencode/test/kilocode/memory/memory-capture.test.ts
• packages/opencode/test/kilocode/memory/memory-command.test.ts
• packages/opencode/test/kilocode/memory/memory-core.test.ts
• packages/opencode/test/kilocode/memory/memory-recall-tool.test.ts
• packages/opencode/test/kilocode/memory/memory-save-tool.test.ts
• packages/opencode/test/kilocode/memory/tool-runtime.ts
• packages/opencode/test/kilocode/server/httpapi-exercise-scenarios.ts
• packages/opencode/test/kilocode/server/httpapi-memory.test.ts
• packages/opencode/test/kilocode/server/httpapi-public.test.ts
• packages/opencode/test/kilocode/session-compaction-cap.test.ts
• packages/opencode/test/kilocode/session-prompt-compaction-safety.test.ts
• packages/opencode/test/kilocode/session-prompt-permission-refresh.test.ts
• packages/opencode/test/kilocode/tool-registry-indexing-import-failure.test.ts
• packages/opencode/test/kilocode/tool-registry-indexing.test.ts
• packages/opencode/test/kilocode/tool-registry-semantic-import-failure.test.ts
• packages/opencode/test/session/prompt.test.ts
• packages/opencode/test/session/snapshot-tool-race.test.ts
• packages/opencode/test/tool/registry.test.ts
• packages/sdk/js/src/v2/gen/sdk.gen.ts
• packages/sdk/js/src/v2/gen/types.gen.ts
• packages/sdk/openapi.json

Fix these issues in Kilo Cloud

---

_{Reviewed by gpt-5.4-20260305 · 243,311 tokens}

_{Review guidance: REVIEW.md from base branch johnnyeric/memory-core-safety}