double-o 0.6.0

Context-efficient command runner for AI coding agents
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

use clap::Parser;
use double_o::{
    Action, check_and_clear_learn_status, cmd_forget, cmd_help, cmd_init, cmd_learn, cmd_patterns,
    cmd_recall, cmd_run, learn, parse_action,
};

// ---------------------------------------------------------------------------
// CLI
// ---------------------------------------------------------------------------

#[derive(Parser)]
#[command(
    name = "oo",
    version,
    about = "Context-efficient command runner for AI coding agents",
    long_about = "oo\n\nContext-efficient command runner for AI coding agents."
)]
struct Cli {
    /// A subcommand, or a command to run. Subcommands:
    /// recall (recall indexed output), forget (clear session index),
    /// learn (auto-generate a compression pattern), help (cheat.sh sheet),
    /// init (set up project hooks), patterns (list compression patterns),
    /// version (print oo version). Any other command runs as a shell command.
    #[arg(trailing_var_arg = true, allow_hyphen_values = true)]
    args: Vec<String>,
}

// ---------------------------------------------------------------------------
// Entry point
// ---------------------------------------------------------------------------

fn main() {
    // Intercept _learn_bg before clap parsing (it's a hidden internal command)
    let raw_args: Vec<String> = std::env::args().collect();
    if raw_args.get(1).is_some_and(|a| a == "_learn_bg") {
        if let Some(path) = raw_args.get(2) {
            let _ = learn::run_background(path);
        }
        std::process::exit(0);
    }

    let cli = Cli::parse();

    // Show any pending learn-status message from a previous background learn.
    // Runs before command dispatch so the user sees the result on the next invocation.
    {
        let status_path = learn::learn_status_path();
        check_and_clear_learn_status(&status_path);
    }

    let exit_code = match parse_action(&cli.args) {
        Action::Help(None) => {
            println!("oo — Context-efficient command runner for AI coding agents");
            println!();
            println!("Usage: oo <command> [args...]");
            println!();
            println!("Commands:");
            println!("  recall [--full] <query>   Search session output");
            println!("  forget                     Clear session data");
            println!("  learn [--hint <text>] <cmd> [args...]   Learn output compression patterns");
            println!(
                "  help [cmd]                 Show help (or cheat-sheet for cmd via cheat.sh)"
            );
            println!("  init [format]              Set up hooks for agent frameworks");
            println!("  patterns                   List output compression patterns");
            println!("  version                    Show version");
            println!();
            println!("Any other command is run in the shell, e.g. oo git log");
            0
        }
        Action::Help(Some(cmd)) => cmd_help(&cmd),
        Action::Version => {
            println!("oo {}", env!("CARGO_PKG_VERSION"));
            0
        }
        Action::Run(args) => cmd_run(&args),
        Action::Recall { query, full } => cmd_recall(&query, full),
        Action::Forget => cmd_forget(),
        Action::Learn(args, hint) => cmd_learn(&args, hint.as_deref()),
        Action::Init(format) => cmd_init(format),
        Action::Patterns => cmd_patterns(),
    };

    std::process::exit(exit_code);
}