talon-cli 0.4.1

Talon CLI: hybrid retrieval over Obsidian vaults and markdown corpora, with grounded answers, MCP server, and agent-native output.
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
128
129
130
131
132
133

//! CLI argument parsing via `clap` derive.

mod ask_args;
mod changes_args;
mod init_args;
mod inspect_args;
mod meta_args;
mod read_args;
mod recall_args;
mod related_args;
pub mod scope;
mod search_args;
mod status_args;
mod sync_args;
mod where_clause;

pub use where_clause::parse_where_clause;

pub use ask_args::AskArgs;
pub use changes_args::ChangesArgs;
use clap::{Parser, Subcommand};
pub use init_args::InitArgs;
pub use inspect_args::InspectArgs;
pub use inspect_args::InspectCheck;
pub use meta_args::MetaArgs;
pub use read_args::ReadArgs;
pub use recall_args::RecallArgs;
pub use related_args::RelatedArgs;
pub use scope::SharedScopeArgs;
pub use search_args::{CliSearchMode, SearchArgs, SharedSearchArgs};
pub use status_args::StatusArgs;
pub use sync_args::SyncArgs;

#[derive(Debug, Clone, clap::Args)]
pub struct SecretsArgs {
    #[command(subcommand)]
    pub subcommand: crate::command::secrets::SecretsSubcommand,
}

/// Talon — Obsidian vault search, indexing, and MCP server.
#[allow(clippy::struct_excessive_bools)]
#[derive(Debug, Clone, Parser)]
#[command(
    name = "talon",
    version = env!("CARGO_PKG_VERSION"),
    subcommand_required = false,
    about = "Obsidian vault search, indexing, and MCP server.",
    before_help = crate::banner::help_banner_colored(),
    after_help = r#"Examples:
  talon search "project setup" --mode hybrid
  talon read src/main.rs --from-line 10 --max-lines 20
  talon related src/lib.rs --depth 2 --direction both
  talon sync --force
  talon sync --rebuild --fast

Use 'talon <command> --help' for per-command help."#
)]
pub struct Cli {
    /// Print embedded SKILL.md.
    #[arg(long, global = true)]
    pub skill: bool,

    /// Token-efficient JSON for agents. Disables human banner and spinner.
    #[arg(long, global = true, conflicts_with = "verbose")]
    pub agent: bool,

    /// Emit JSON output.
    #[arg(long, global = true)]
    pub json: bool,

    /// Use fast mode for search or sync.
    #[arg(long, global = true)]
    pub fast: bool,

    /// Include diagnostic details in output.
    #[arg(short, long, global = true)]
    pub verbose: bool,

    /// Read config from PATH.
    #[arg(short = 'c', long = "config", global = true, value_hint = clap::ValueHint::FilePath)]
    pub config_file: Option<std::path::PathBuf>,

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

#[derive(Debug, Clone, Subcommand)]
pub enum Commands {
    #[command(about = "Initialize a new talon configuration file.")]
    Init(InitArgs),

    #[command(about = "Sync your vault with the search index.")]
    Sync(SyncArgs),

    #[command(about = "Show vault index status.")]
    Status(StatusArgs),

    #[command(about = "Search your Obsidian vault using hybrid ranking.")]
    Search(SearchArgs),

    #[command(about = "Ask a vault-grounded question.")]
    Ask(AskArgs),

    #[command(about = "Read a note from your vault.")]
    Read(ReadArgs),

    #[command(about = "Find related notes via wikilink traversal.")]
    Related(RelatedArgs),

    #[command(about = "Query frontmatter metadata from your vault.")]
    Meta(MetaArgs),

    #[command(about = "Show vault changes since a timestamp.")]
    Changes(ChangesArgs),

    #[command(about = "Inspect your vault for structural signals and patterns.")]
    Inspect(InspectArgs),

    #[command(about = "Recall relevant vault context for a message.")]
    Recall(RecallArgs),

    #[command(about = "Manage API keys stored in the OS keychain.")]
    Secrets(SecretsArgs),

    #[command(about = "Run MCP-over-stdio mode.")]
    Mcp,
}

/// Parses CLI args or exits on error.
#[must_use]
pub fn parse_or_exit() -> Cli {
    Cli::parse()
}