MCPcopy Index your code
hub / github.com/GabAlpha/basilk

github.com/GabAlpha/basilk @0.2.1

Chat with this repo
repository ↗ · DeepWiki ↗ · release 0.2.1 ↗ · + Follow
67 symbols 79 edges 10 files 1 documented · 1%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

illustration generated using perchance.org

basilk

A Terminal User Interface (TUI) to manage your tasks with minimal kanban logic

History

It was a very hot August night, and I was organizing my activities when at a certain point I felt the need for a software that could help me with this, something simple and portable. basilk is created as a summer project to learn Rust and to be able to use the software anywhere.

The name /ˈbæzəlkeɪ/ comes from the basil plant, which is easy to grow and maintain, and "k" stands for kanban.

Another story

illustration generated using perchance.org

The name /ˈbæzsɪlk/ comes from the union of basil and silk as a symbol of elaborateness due to its production process.

About

basilk is structured to create projects and within each project to create tasks with a specific status (Up Next/On Going/Done).

The data structure is saved in .json format and is available in the directory:

Linux
~/.config/basilk

macOS
~/Library/Application Support/basilk

Windows
<USER>\AppData\Roaming\basilk

The choice to use the JSON format is to make easier to export

Installation

Cargo

from crates.io using cargo

cargo install basilk

AUR

from the AUR with using an AUR helper.

paru -S basilk

Homebrew

from a homebrew tap using brew

brew tap GabAlpha/tap
brew install basilk

Build from source

  1. Clone the repository
git clone https://github.com/GabAlpha/basilk && cd basilk
  1. Build
cargo build --release

Binary will be located at target/release/basilk

Usage

Run

basilk

All available commands are displayed inside

Contributing

[!NOTE]
This project is now in beta version and is expected to have bugs

As I mentioned above, this is my first project in Rust, so contributions and help are welcome! If you have any suggestions, improvements, or bug fixes, feel free to submit a pull request or open a new issue.

License

License: MIT License: Apache 2.0

Licensed under either of Apache License Version 2.0 or The MIT License at your option.

Core symbols most depended-on inside this repo

use_state
called by 7
src/main.rs
next
called by 5
src/main.rs
previous
called by 4
src/main.rs
init_terminal
called by 1
src/main.rs
restore_terminal
called by 1
src/main.rs
run
called by 1
src/main.rs
render
called by 1
src/main.rs
get_default
called by 0
src/config.rs

Shape

Method 51
Class 12
Function 3
Enum 1

Languages

Rust100%

Modules by API surface

src/task.rs13 symbols
src/main.rs12 symbols
src/view.rs9 symbols
src/project.rs8 symbols
src/json.rs6 symbols
src/config.rs6 symbols
src/ui.rs5 symbols
src/util.rs3 symbols
src/migration.rs3 symbols
src/cli.rs2 symbols

For agents

$ claude mcp add basilk \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page