squeez 1.5.0

End-to-end token optimizer for Claude Code, Copilot CLI, and OpenCode. Compresses bash output up to 95%, collapses redundant calls, injects caveman persona, and compresses memory files. Zero new dependencies.
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

//! Host adapter registry — one implementation per supported CLI agent.
//!
//! Each CLI (Claude Code, Copilot CLI, OpenCode, Gemini CLI, Codex CLI) has
//! a distinct config file layout, hook format, and memory-injection channel.
//! The `HostAdapter` trait abstracts those differences so `squeez setup`,
//! `squeez uninstall`, and the session-start flow can treat every host
//! uniformly.
//!
//! Real adapters live in dedicated per-host modules (`claude_code`,
//! `copilot`, ...). Hosts still waiting on migration (US-004 .. US-006)
//! keep their stub impl at the bottom of this file.

pub mod claude_code;
pub mod codex;
pub mod copilot;
pub mod gemini;
pub mod opencode;
pub use claude_code::ClaudeCodeAdapter;
pub use codex::CodexCliAdapter;
pub use copilot::CopilotCliAdapter;
pub use gemini::GeminiCliAdapter;
pub use opencode::OpenCodeAdapter;

use std::path::{Path, PathBuf};

use crate::config::Config;
use crate::memory::Summary;

// ── Capability bitflags (zero-dep: plain u8 newtype) ───────────────────────

/// What a host can do natively. See the host capability matrix in
/// `docs/superpowers/specs/2026-04-18-cli-host-coverage-design.md`.
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
pub struct HostCaps(pub u8);

impl HostCaps {
    pub const NONE: Self = Self(0);
    /// Host can intercept Bash tool calls before execution.
    pub const BASH_WRAP: Self = Self(0b0001);
    /// Host offers a session-start hook OR a stable memory file we can inject into.
    pub const SESSION_MEM: Self = Self(0b0010);
    /// Host can rewrite tool_input for Read/Grep/Glob (programmatic enforcement).
    pub const BUDGET_HARD: Self = Self(0b0100);
    /// Host only supports soft budget hints via an auto-loaded markdown file.
    pub const BUDGET_SOFT: Self = Self(0b1000);

    pub const fn contains(self, other: Self) -> bool {
        (self.0 & other.0) == other.0
    }
}

impl std::ops::BitOr for HostCaps {
    type Output = Self;
    fn bitor(self, rhs: Self) -> Self {
        Self(self.0 | rhs.0)
    }
}

// ── Trait ──────────────────────────────────────────────────────────────────

pub trait HostAdapter {
    /// Stable slug used on the command line (e.g. `squeez setup --host=gemini`).
    fn name(&self) -> &'static str;

    /// Returns true when the host's config directory is present on disk,
    /// indicating the user has the CLI installed and squeez should offer to
    /// integrate with it.
    fn is_installed(&self) -> bool;

    /// Squeez's per-host state directory (sessions/, memory/, config.ini).
    fn data_dir(&self) -> PathBuf;

    /// What this host supports natively.
    fn capabilities(&self) -> HostCaps;

    /// Register squeez hooks/plugin into the host's settings. Idempotent.
    fn install(&self, bin_path: &Path) -> std::io::Result<()>;

    /// Remove squeez entries from the host's settings, leaving everything
    /// else intact. Idempotent.
    fn uninstall(&self) -> std::io::Result<()>;

    /// Write the squeez memory block into the host's auto-loaded instructions
    /// file (CLAUDE.md / copilot-instructions.md / GEMINI.md / AGENTS.md).
    fn inject_memory(&self, cfg: &Config, summaries: &[Summary]) -> std::io::Result<()>;
}

// ── Registry ───────────────────────────────────────────────────────────────

pub fn all_hosts() -> Vec<Box<dyn HostAdapter>> {
    vec![
        Box::new(ClaudeCodeAdapter),
        Box::new(CopilotCliAdapter),
        Box::new(OpenCodeAdapter),
        Box::new(GeminiCliAdapter),
        Box::new(CodexCliAdapter),
    ]
}

/// Look up an adapter by its `name()` slug.
pub fn find(slug: &str) -> Option<Box<dyn HostAdapter>> {
    all_hosts().into_iter().find(|h| h.name() == slug)
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn bash_wrap_flag_round_trips() {
        let c = HostCaps::BASH_WRAP | HostCaps::SESSION_MEM;
        assert!(c.contains(HostCaps::BASH_WRAP));
        assert!(c.contains(HostCaps::SESSION_MEM));
        assert!(!c.contains(HostCaps::BUDGET_HARD));
    }

    #[test]
    fn find_returns_claude_code() {
        let a = find("claude-code").expect("adapter");
        assert_eq!(a.name(), "claude-code");
    }

    #[test]
    fn find_returns_none_for_unknown() {
        assert!(find("nonexistent").is_none());
    }
}