Skip to content

feat: AI agent integration — auto-start, setup wizard, document engine, room UI #55

Description

@ajianaz

Agent Integration — CorIn sebagai Interface untuk AI Agent Memory

CorIn harus menjadi jembatan antara AI coding agents (Claude Code, Pi Dev, OpenCode) dan Uteke memory engine. Saat ini setup dilakukan manual — CorIn harus otomatisasi ini.

1. Auto-start uteke-serve on app launch

Prioritas: CRITICAL — tanpa ini, semua MCP integration tidak berfungsi.

Saat CorIn launch:

  • Cek apakah uteke-serve sudah jalan di port 8767
  • Jika tidak → spawn sebagai child process (atau via launchd/systemd)
  • Auto-detect path: ~/.cargo/bin/uteke-serve atau ~/.local/bin/uteke-serve
  • Show status di sidebar (sudah ada, tinggal connect ke process management)

2. Agent Setup Wizard

Settings → "AI Agents" section:

┌──────────────────────────────────────┐
│  AI Agent Integration                 │
│                                       │
│  Detected agents:                     │
│  ✓ Claude Code (~/.claude/)           │
│  ✓ Pi Dev (~/.pi/)                    │
│  ○ OpenCode (not found)               │
│                                       │
│  [Enable Uteke Memory for Claude Code]│
│  [Enable Uteke Memory for Pi Dev]     │
│                                       │
│  When enabled:                        │
│  1. Start uteke-serve                 │
│  2. Write .mcp.json to project        │
│  3. Generate .agent.md with recall    │
│     instructions                      │
└──────────────────────────────────────┘

Steps:

  • Detect agent installations (check config dirs, PATH)
  • Write MCP config to correct location per agent
  • Generate .agent.md with: "Before starting any task, call uteke_recall to get project context. After learning something new, call uteke_remember to store it."
  • Toggle on/off per agent

3. Document Engine (CodeMirror + uteke doc)

Uteke v0.3.x sudah punya document engine:

  • uteke doc create/get/list/delete/export
  • Auto-chunk per heading, each chunk gets embedding
  • uteke doc search — chunk-level semantic search

CorIn needs:

  • CodeMirror 6 markdown editor (sudah di package.json deps)
  • Doc list view (sidebar atau tab baru)
  • Doc search bar
  • Doc → memory linking (show related memories)
  • Export to .md file

4. Room Management UI

Uteke sudah punya room API:

  • room create/recall/summary/document
  • Room participants with author attribution
  • room_remember — store memory to room with author

CorIn needs:

  • Room list dengan participant count + memory count
  • Create room form (title, namespace)
  • Room detail: timeline of memories (who said what, when)
  • Room summary viewer (topic clustering)
  • Invite agent to room (set namespace + author)

5. Dream Cycle Button

Uteke punya uteke dream (lint → backlinks → dedup → orphans → compact).

CorIn needs:

  • Settings → "Maintenance" section
  • Button: "Run Dream Cycle" — jalankan dan show results
  • Auto-schedule: weekly run via launchd/systemd/cron
  • Show last run time + results summary

6. Auto-generate .agent.md

When user enables agent integration, CorIn generates:

# Agent Instructions

## Memory Protocol
- Before starting any task: call `uteke_recall("project context, conventions, decisions")` to get relevant memories
- After discovering something important: call `uteke_remember` with tags and namespace
- Use namespaces to isolate: "corin", "uteke", "trapfall"

## Project Context
- Stack: Tauri 2 + Svelte 5 + Rust
- DB: SQLite via rusqlite 0.40
- Embedding: ONNX embeddinggemma-q4 (768d)

Priority

Feature Priority Phase
Auto-start uteke-serve CRITICAL v0.2.0
Agent setup wizard HIGH v0.2.0
.agent.md generation HIGH v0.2.0
Document engine MEDIUM v0.2.0
Room UI MEDIUM v0.3.0
Dream cycle button LOW v0.3.0

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions