kimun_notes/cli/
mod.rs

1// tui/src/cli/mod.rs
2pub mod commands;
3pub mod helpers;
4pub mod json_output;
5pub mod metadata_extractor;
6pub mod output;
7
8use clap::Subcommand;
9use color_eyre::eyre::{Result, eyre};
10use commands::JournalArgs;
11use commands::note_ops::NoteSubcommand;
12use commands::workspace::WorkspaceSubcommand;
13use helpers::{
14    create_and_init_vault, load_and_resolve_workspace, load_settings, resolve_inbox_path,
15    resolve_quick_note_path,
16};
17use kimun_core::{NoteVault, VaultConfig};
18use output::OutputFormat;
19
20#[derive(Subcommand)]
21pub enum CliCommand {
22    /// Search notes by query
23    Search {
24        query: String,
25        #[arg(long, value_enum, default_value = "text")]
26        format: OutputFormat,
27    },
28    /// List all notes
29    Notes {
30        #[arg(long, help = "Filter notes by path prefix")]
31        path: Option<String>,
32        #[arg(long, value_enum, default_value = "text")]
33        format: OutputFormat,
34    },
35    /// Manage workspaces
36    Workspace {
37        #[command(subcommand)]
38        subcommand: WorkspaceSubcommand,
39    },
40    /// Note operations (create, append, show)
41    Note {
42        #[command(subcommand)]
43        subcommand: NoteSubcommand,
44    },
45    /// Append to or show journal entries
46    Journal(JournalArgs),
47    /// Start the MCP server (stdio transport)
48    Mcp,
49    /// List all hashtag labels in the vault with note counts
50    Labels {
51        #[arg(long, value_enum, default_value = "text")]
52        format: OutputFormat,
53    },
54    /// Check for a newer release and, where possible, self-update
55    Update {
56        /// Only check and report; do not download or install
57        #[arg(long)]
58        check: bool,
59    },
60}
61
62pub async fn run_cli(command: CliCommand, config_path: Option<std::path::PathBuf>) -> Result<()> {
63    match command {
64        CliCommand::Workspace { subcommand } => {
65            let mut settings = load_settings(config_path)?;
66            commands::workspace::run(subcommand, &mut settings).await
67        }
68        CliCommand::Note { subcommand } => {
69            let (settings, workspace_path, workspace_name) =
70                load_and_resolve_workspace(config_path)?;
71            let quick_note_path = resolve_quick_note_path(&settings);
72            let inbox_path = resolve_inbox_path(&settings);
73            let cache_path = settings.cache_path_for(&workspace_name);
74            let mut vault = NoteVault::new(
75                VaultConfig::new(&workspace_path)
76                    .with_db_path(cache_path)
77                    .with_backup(true),
78            )
79            .await?;
80            vault.set_inbox_path(kimun_core::nfs::VaultPath::new(&inbox_path));
81            if vault.index_ready() {
82                commands::note_ops::run(subcommand, &vault, &quick_note_path, &workspace_name).await
83            } else {
84                Err(eyre!(
85                    "Workspace index is not ready.\nRun `kimun workspace reindex` to initialise it."
86                ))
87            }
88        }
89        CliCommand::Search { query, format } => {
90            let (vault, workspace_name) = create_and_init_vault(config_path).await?;
91            commands::search::run(&vault, &query, format, &workspace_name, false).await
92        }
93        CliCommand::Notes { path, format } => {
94            let (vault, workspace_name) = create_and_init_vault(config_path).await?;
95            commands::notes::run(&vault, path.as_deref(), format, &workspace_name, false).await
96        }
97        CliCommand::Journal(args) => {
98            let (vault, workspace_name) = create_and_init_vault(config_path).await?;
99            commands::journal::run(args, &vault, &workspace_name).await
100        }
101        CliCommand::Mcp => commands::mcp::run(config_path).await,
102        CliCommand::Labels { format } => {
103            let (vault, workspace_name) = create_and_init_vault(config_path).await?;
104            commands::labels::run(&vault, format, &workspace_name).await
105        }
106        // Update is vault-independent: it talks to GitHub and the app config
107        // dir, not a workspace.
108        CliCommand::Update { check } => commands::update::run(check).await,
109    }
110}
kimun_notes/cli/mod.rs

kimun_notes/cli/
mod.rs
