Repository files navigation

Deltos is a magic notepad, a tool for managing personal information.

Install with npm.

npm install -g deltos

Make surebin/deltos is in your path.

deltos initdeltos post My First Post

Write a post. The header is just YAML, so feel free to add fields. Write alittle note and put some tags in thetags field, comma separated. Then closeyour editor.

You can search all your posts by just running:

deltos search

Just type to filter entries displayed, and select one from the list to edit it.

If you use vim you'll want to checkdeltos.vim.

Deltos is a system for personal information management that I made for myself.

I like wikis, but setting them up can be tedious. Running a DB is a hassle, andI want to be able to use my own text editor. Even if a wiki uses flat filesthere are still issues.

• Unicode support is typically mediocre
• Thinking up titles is tedious
• Links break and chaos is unleashed when titles change

There are downsides to using uuid keys, but I realized I don't really careabout them. The most important thing isI want to start writing just bypushing a button. The next most important thing isI want to find what I'vewritten before. Tags, rich metadata, and files that work with the tools I'mused to (grep and so on) seemed like the best way to do that.

A secondary goal is the ability to dump documents to HTML so as to share themmore easily. You are encouraged to rip that bit out and replace it withsomething that fits your needs.

You create a note. A note probably has a title, has tags, and has a Body, whichis just another kind of metadata but rather longer. The important thing iswriting the body down and not having to think too much about the title orgetting the metadata correct.

Coming back to what you've written, it's important to be able to organize byvarious metadata fields, to link notes together, and to use outlines toorganize notes in hierarchies when tags don't cut it. You should also be ableto edit an article, including its metadata, without breaking links ordisrupting the integrity of your web.

CC0, WTFPL, Kopyleft All Rites Reversed. Do as you like.

-POLM