#zettelkasten #notes #note-taking #zettel

app settle

CLI tool for managing a digital Zettelkasten

19 unstable releases (5 breaking)

0.39.5 Feb 1, 2023
0.38.1 Aug 11, 2022
0.37.2 Jun 14, 2022
0.36.1 Mar 7, 2022

#618 in Command line utilities

Download history 23/week @ 2022-11-24 13/week @ 2022-12-01 15/week @ 2022-12-08 13/week @ 2022-12-15 2/week @ 2022-12-22 8/week @ 2022-12-29 9/week @ 2023-01-05 3/week @ 2023-01-12 87/week @ 2023-01-19 63/week @ 2023-01-26 21/week @ 2023-02-02 32/week @ 2023-02-09 58/week @ 2023-02-16 2/week @ 2023-02-23 38/week @ 2023-03-02 1/week @ 2023-03-09

109 downloads per month

MIT license

47KB
994 lines

settle

settle is a CLI tool that helps you manage your digital Zettelkasten.

Getting started

Requirements

  • cargo/rust toolchain
  • SQLite

Installation

There's a crate on crates.io, so you can simply run:

cargo install settle

Overview

Roadmap

Before 2023

  • generate the database from existing files
  • create Zettel
  • list Zettel
  • tags
    • recognize hashtag-tags (e.g. #interesting-tag)
    • search for tags
    • list all tags
  • configuration
    • custom Zettelkasten directory
    • custom database file path
    • be able to use templates
  • list mentioned but non-existent Zettel ("ghosts")
  • search for text inside notes
  • update Zettel metadata individually
  • projects (subdirectories within the main Zettelkasten folder)
    • add notes to projects
    • create an inbox project by default
    • generate the database with projects included
    • start with an 'inbox' project by default
    • move notes from project to project
  • rename notes
    • update all links to the renamed note

After/During 2023

  • query: filter notes based on various criteria (title, tags, etc.)
    • support regex
    • print according to a format
    • put custom separator between links, both forward and backward
  • graph
    • DOT output
    • render DOT as image
  • writing experience (help deal with writer's block)
    • find related notes
    • suggest random notes

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

MIT

Dependencies

~33MB
~623K SLoC