settle

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

Getting started

Requirements

• cargo/rust toolchain (for building)
• SQLite (for running)

Installation

There's a Rust crate available, so you can simply run:

cargo install settle

Overview

• full usage manual, contains more technical descriptions
• project motivation
• design principles
• configuration
• tags and subtags
• links and backlinks
• creating new notes (with templates as well)
• keeping the database up to date
• projects
  • moving notes between projects
• renaming notes
• query, search and filter
  • making a graph of your Zettelkasten

Roadmap

• 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
• simplify command structure
• 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
  • add option to print DOT graphs, which can be read with e.g. graphviz
• writing experience (help deal with writer's block)
  • find related notes

Contributing

Pull requests are welcome. For any minor or major changes, you can open an issue to discuss what you would like to change.

License

MIT