Skip to content

jotlabsorg/jottty

Repository files navigation

Jottty.

Jottty is a simple and efficient note-taking application designed to help you capture your thoughts, ideas, and to-do lists quickly. With a clean and intuitive interface, Jottty makes it easy to organize your notes and access them whenever you need.

img

What jot means?

To jot = to make a short, quick note so you don’t forget.

view

How run and install.

Run via cargo

For now , you can only run via cargo:

cargo run  <command> [args]

or build the binary and run:

cargo build --release
./target/release/jottty <command> [args]

Install via script

Download the installer and run it:

curl -sSL https://raw.githubusercontent.com/j0tlabs/jottty/main/install.sh | bash

Install to a custom directory or version:

./install.sh --dir "$HOME/.local/bin"
./install.sh --version v0.1.0

Usage

> jottty add "This is a bullet note in today's journal"

You can list all your journals:

> jottty list
journals/
  ├── 2026-01-10.md
  ├── 2026-01-09.md
  └── 2026-01-08.md

You can view a specific journal by date:

> jottty view 2026-01-09  
# 2026-01-09
- This is a bullet note in past journal

More commands:

> jottty view   ;; can view the todays journal directlyf    
> jottty add "TODO: Finish the project" ;; TODO: is a tag
> jottty search "TODO" ;; search all journals for the string
> jottty tag --filter "TODO" ;; list all tags

You can also edit the file directly: This will open the today's journal in your default text editor or you can set the EDITOR in the configuration file.

> jottty edit

Configuration

You can configure jottty by creating a configuration file at ~/.jottty/config.toml. Here is an example configuration:

bullet_prefix = "- "
editor = "nvim"
dir = "~/.jottty"

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests on the GitHub repository. The tasks for the project are tracked in the tasks document, or you can check the issues on GitHub.

About

Jottty is a simple note app terminal (tty)

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors