cliban 0.3.0

Self-hosted, agent-first kanban for the terminal: flat CLI, ratatui board, SQLite storage
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

use clap::Parser;

mod cmd;
mod descmd;
use cliban::migrate;

mod audit;
mod errors;
mod output;
mod search;
mod since;
mod store_open;

#[derive(clap::Args)]
struct MigrateLegacyArgs {
    /// path to the legacy Go SQLite db to read (read-only)
    #[arg(long)]
    from: String,
    /// path to the new cliban-core db to create (must not exist)
    #[arg(long)]
    to: String,
}

#[derive(Parser)]
#[command(
    name = "cliban",
    version,
    about = "AI-agent-first kanban board for the terminal"
)]
struct Cli {
    /// path to SQLite DB (default: $CLIBAN_DB or $XDG_DATA_HOME/cliban/cliban.db)
    #[arg(long, global = true)]
    db: Option<String>,
    #[command(subcommand)]
    cmd: Option<Command>,
}

#[derive(clap::Subcommand)]
enum Command {
    /// Open the kanban TUI
    Tui,
    /// Manage projects
    Project(cmd::project::ProjectArgs),
    /// Manage labels
    Label(cmd::label::LabelArgs),
    /// Manage issues
    Issue(cmd::issue::IssueArgs),
    /// What changed on the board recently (newest first)
    Activity(cmd::activity::ActivityArgs),
    /// Manage milestones
    Milestone(cmd::milestone::MilestoneArgs),
    /// Fuzzy-find issues; print selected key to stdout
    Fff(cmd::fff::FffArgs),
    /// Import an issue from an external tracker
    #[cfg(feature = "linear")]
    Import(cmd::sync::ImportArgs),
    /// Push a cliban issue back to an external tracker
    #[cfg(feature = "linear")]
    Push(cmd::sync::PushArgs),
    /// Migrate a legacy Go cliban db into a fresh cliban-core db
    MigrateLegacy(MigrateLegacyArgs),
}

fn main() {
    let cli = Cli::parse();

    // The TUI is synchronous and owns its own runtime (see cliban-tui::data),
    // so it must run OUTSIDE a tokio runtime — launch it before we build one.
    if matches!(cli.cmd, None | Some(Command::Tui)) {
        let path = store_open::db_path(&cli.db);
        if let Err(e) = cliban_tui::run(path) {
            eprintln!("error: {e}");
            std::process::exit(1);
        }
        return;
    }

    let rt = tokio::runtime::Builder::new_current_thread()
        .enable_all()
        .build()
        .expect("build tokio runtime");
    if let Err(e) = rt.block_on(run(cli)) {
        eprintln!("error: {}", e.message());
        std::process::exit(e.code());
    }
}

async fn run(cli: Cli) -> errors::CliResult<()> {
    match cli.cmd {
        None | Some(Command::Tui) => unreachable!("TUI handled in main before runtime"),
        Some(Command::Project(args)) => cmd::project::run(&cli.db, args).await,
        Some(Command::Label(args)) => cmd::label::run(&cli.db, args).await,
        Some(Command::Issue(args)) => cmd::issue::run(&cli.db, args).await,
        Some(Command::Activity(args)) => cmd::activity::run(&cli.db, args).await,
        Some(Command::Milestone(args)) => cmd::milestone::run(&cli.db, args).await,
        Some(Command::Fff(args)) => cmd::fff::run(&cli.db, args).await,
        #[cfg(feature = "linear")]
        Some(Command::Import(args)) => cmd::sync::run_import(&cli.db, args).await,
        #[cfg(feature = "linear")]
        Some(Command::Push(args)) => cmd::sync::run_push(&cli.db, args).await,
        Some(Command::MigrateLegacy(args)) => {
            let report = migrate::migrate(
                std::path::Path::new(&args.from),
                std::path::Path::new(&args.to),
            )
            .map_err(errors::CliError::other)?;
            println!(
                "migrated: {} projects, {} milestones, {} issues, {} labels, {} issue_labels, {} relations",
                report.projects, report.milestones, report.issues, report.labels,
                report.issues_labels, report.relations,
            );
            Ok(())
        }
    }
}