codeix 0.5.0

Fast semantic code search for AI agents — find symbols, references, and callers across any codebase
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

use std::io::IsTerminal;
use std::path::Path;

use anyhow::Result;
use clap::{Parser, Subcommand};

#[derive(Parser)]
#[command(
    name = "codeix",
    about = "Portable, composable code index\n\nhttps://codeix.dev"
)]
struct Cli {
    /// Root directory (defaults to current dir)
    #[arg(short = 'r', long = "root", global = true, default_value = ".")]
    root: String,

    #[command(subcommand)]
    command: Option<Commands>,
}

#[derive(Subcommand)]
enum Commands {
    /// Build the .codeindex/ for discovered projects
    Build,
    /// Start the MCP server (default when stdin is piped)
    Serve {
        /// Disable file watching
        #[arg(long)]
        no_watch: bool,
    },
    /// Interactive query REPL (default when in a terminal)
    ///
    /// Run 'codeix query help' to see available commands.
    Query {
        /// Disable file watching
        #[arg(long)]
        no_watch: bool,
        /// Command to execute (if omitted, starts REPL)
        #[arg(trailing_var_arg = true, allow_hyphen_values = true)]
        command: Vec<String>,
    },
}

fn main() -> Result<()> {
    tracing_subscriber::fmt()
        .with_env_filter(tracing_subscriber::EnvFilter::from_default_env())
        .init();

    let cli = Cli::parse();
    let root = Path::new(&cli.root);

    let command = cli.command.unwrap_or_else(|| {
        if std::io::stdin().is_terminal() {
            // Interactive terminal: default to query REPL
            Commands::Query {
                no_watch: false,
                command: vec![],
            }
        } else {
            // Piped stdin (e.g. MCP client): default to serve
            Commands::Serve { no_watch: false }
        }
    });

    match command {
        Commands::Build => {
            codeix::cli::build::run(root)?;
        }
        Commands::Serve { no_watch } => {
            codeix::cli::serve::run(root, !no_watch)?;
        }
        Commands::Query { no_watch, command } => {
            codeix::cli::query::run(root, !no_watch, command)?;
        }
    }

    Ok(())
}