aboutsummaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorMarc Coquand <marc@mccd.space>2024-05-13 11:00:47 -0500
committerMarc Coquand <marc@mccd.space>2024-05-13 11:00:47 -0500
commit121a6a376209de3f5a9474bf03721e2032a73e01 (patch)
tree6f02ffa1695510aa9227a9290abac11811b25373 /README
downloadstitch-121a6a376209de3f5a9474bf03721e2032a73e01.tar.gz
stitch-121a6a376209de3f5a9474bf03721e2032a73e01.tar.bz2
stitch-121a6a376209de3f5a9474bf03721e2032a73e01.zip
initial commit
Diffstat (limited to '')
-rw-r--r--README.md76
1 files changed, 76 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7af7768
--- /dev/null
+++ b/README.md
@@ -0,0 +1,76 @@
+Stitch - Note Composer
+
+Stitch is a minimal grep-based CLI tool for composing notes.
+It is built around the idea of writing notes separately and then
+using tags to compose these notes together.
+
+Stitch does not have any opinion about which file
+format you use for file capturing, use org, markdown, whatever you
+want. You can customize the grep command.
+
+Stitch limits itself only to note composing. For capturing notes, you
+will have to set up your own system.
+
+AIMS
+
+- Single binary
+- Minimal
+- Work with any file format
+
+CREDIT
+
+Stitch is based and largely a stripped down copy of the note composing
+system of Howm for Emacs.
+
+INSTALLATION
+
+Chmod +x the binary and put in PATH.
+
+Set the environment variables:
+
+STICH_DIRECTORY
+STICH_GREP_CMD (default "grep")
+STITCH_HEADLINE_PATTERN (default "^\* ")
+STITCH_TAG_PATTERN (default ":[a-z]:")
+
+SPEED UP
+
+Stitch uses grep by default. As your notes grow, this will
+become rather slow. To speed it up, you can replace it grep with ugrep.
+
+DEVELOPMENT
+
+To set up the project, easiest way is to just install Nix, direnv and
+enable nix flakes. Then to compile:
+
+dune build
+
+And to run:
+
+dune exec -- stitch
+
+
+RECIPES
+
+Building a journaling system
+---
+
+You can build a basic capture command using $EDITOR and date command:
+
+alias capture="JRNL=\"$STITCH_DIRECTORY/$(date +'%Y-%m-%d %H:%M').org\" echo '* :journal:' > $JRNL_FILE && $EDITOR $JRNL_FILE
+
+and then you can find your journal entries, automatically sorted by creation date with
+stitch and the journal tag:
+
+alias jrnl="stitch -t journal"
+
+LICENSE
+
+License is BSD-3-Clause
+
+KNOWN ISSUES
+
+- Resizing the screen when editor is open causes panic
+
+
+