remem-ai 0.6.62

Local-first coding agent memory for Claude Code and OpenAI Codex
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

use anyhow::{bail, Result};
use clap::ValueEnum;
use std::path::PathBuf;

/// Which host(s) to (un)install into.
#[derive(Debug, Clone, Copy, ValueEnum, PartialEq, Eq)]
pub enum InstallTarget {
    /// Install to every host whose config directory already exists.
    Auto,
    /// Install only to Claude Code (~/.claude.json + ~/.claude/settings.json).
    Claude,
    /// Install only to Codex (~/.codex/config.toml).
    Codex,
    /// Install only to Cursor (~/.cursor/hooks.json + ~/.cursor/mcp.json).
    Cursor,
    /// Install to every known host, creating config files if missing.
    All,
}

/// Outcome of a hook installation attempt.
pub enum HookSupport {
    /// Hooks were installed.
    Installed,
    /// Host does not support hooks; reason for user-visible log.
    /// Retained for future hosts (e.g. Cursor) that may not expose a hook
    /// system with the same shape as Claude/Codex.
    #[allow(dead_code)]
    Skipped(&'static str),
}

pub struct HookRepairReport {
    pub path: PathBuf,
    pub registered: usize,
    pub expected: usize,
    pub mcp_warning: Option<String>,
    pub scope_warning: Option<String>,
}

/// A host capable of running the remem MCP server.
///
/// Each host owns its own config file format and mutation logic. The runtime
/// layer only orchestrates which hosts to touch.
pub trait InstallHost {
    /// Short identifier printed in logs (e.g. "claude", "codex").
    fn name(&self) -> &'static str;

    /// Path to the primary config file this host manages.
    fn config_path(&self) -> PathBuf;

    /// True when the host appears to be installed on this machine.
    /// Used by `InstallTarget::Auto` to decide whether to touch it.
    fn is_available(&self) -> bool;

    /// Add / update the remem MCP server entry. Idempotent.
    fn install_mcp(&self, bin: &str) -> Result<()>;

    /// Remove any remem MCP server entry. Idempotent.
    fn uninstall_mcp(&self, bin: &str) -> Result<()>;

    /// Add / update remem hooks. Hosts without hook support return `Skipped`.
    fn install_hooks(&self, bin: &str) -> Result<HookSupport>;

    /// Repair host hooks without touching MCP, runtime store, or tokens.
    fn repair_hooks(&self, _bin: &str) -> Result<HookRepairReport> {
        bail!("{} hook repair is not supported", self.name())
    }

    /// Remove remem hooks. No-op if the host doesn't support hooks.
    fn uninstall_hooks(&self, bin: &str) -> Result<()>;

    /// Describe the writes a real install would do, without touching disk.
    /// Returned lines are printed verbatim in dry-run mode.
    fn dry_run_plan(&self, bin: &str) -> Vec<String>;
}