{"id":19016054,"url":"https://github.com/jhuntwork/jote","last_synced_at":"2026-06-25T11:31:06.356Z","repository":{"id":61623180,"uuid":"535379974","full_name":"jhuntwork/jote","owner":"jhuntwork","description":"jote jots down notes","archived":false,"fork":false,"pushed_at":"2023-11-29T18:57:37.000Z","size":38,"stargazers_count":2,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-01T23:11:28.576Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jhuntwork.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-09-11T17:52:37.000Z","updated_at":"2022-12-12T03:55:59.000Z","dependencies_parsed_at":"2024-06-20T08:23:51.761Z","dependency_job_id":"f48ee3cc-8a3b-4da0-bd16-97a1542f3c25","html_url":"https://github.com/jhuntwork/jote","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhuntwork%2Fjote","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhuntwork%2Fjote/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhuntwork%2Fjote/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhuntwork%2Fjote/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jhuntwork","download_url":"https://codeload.github.com/jhuntwork/jote/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240059403,"owners_count":19741647,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-08T19:40:43.196Z","updated_at":"2026-04-26T12:30:19.584Z","avatar_url":"https://github.com/jhuntwork.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Jote\n\nJote is a simple Markdown notes manager.\n\n## Why?\n\nI wanted a simple way of organizing my notes, without being required to use a\nnew editor, or being bound to a specific editor. By design, such a method\nshould at minium be:\n\n- Frictionless to use, especially when adding a new note\n- Usable by any editor (that can be invoked by the command line)\n- Automatically backed by git\n- Able to support any hierarchy\n- Searchable via custom tags\n\n## Installing\n\nFor now, the easiest way to install is:\n\n```sh\ngo install github.com/jhuntwork/jote/cmd/jote@latest\n```\n\n## Usage\n\n### New notes\n\nTo create a new note, simply run `jote new` or just `jote`. If you have the\n`EDITOR` environment variable set, that command will be invoked to open a new\nfile. The `EDITOR` command should block until the file is closed. For example,\nthe default command is `vim --nofork`, which means vim launches in the\nforeground and will block until you close the editor. A similar command for\nVS Code would be `code -w`.\n\nOn first run, `jote` will initialize a git repository in `~/.local/share/jote`.\nBecause all further actions there are git actions, you can interact with it as\nyou would any other git repository.\n\nNew files will contain the following template:\n\n```md\n---\ntitle:\ntags: []\n---\n```\n\nThe section between the `---` lines is considered front matter and is parsed as\nyaml. If you provide a title, the file will be saved as `[title].md`, otherwise\nthe file will be named with a unix timestamp of the current time.\n\n`title` is interpreted as a relative path in the git repository. This means that\nnotes can support a structured hierarchy. For example:\n\n```yaml\ntitle: recipes/Asian Food/Spicy Thai Noodles\n```\n\nThe resulting file would be named\n`~/.local/share/jote/recipes/Asian Food/Spicy Thai Noodles.md`.\n\n`tags` is a list of strings, so it can either be specified like this:\n\n```yaml\ntags: [one, two, \"another tag\"]\n```\n\nor like this:\n\n```yaml\ntags:\n  - one\n  - two\n  - another tag\n```\n\nEverything following the front matter section is the actual Markdown content.\n\n### Listing all notes\n\nRun `jote ls`. This will provide a `fzf`-like interface (via\n[go-fuzzyfinder](https://github.com/ktr0731/go-fuzzyfinder)) to list all notes.\nSelecting a note will open it for editing.\n\nChanges made to pre-existing notes via the jote interface will result in a new\ngit commit tracking that change. Changing the title will move the file to the\nnew location.\n\n### Searching by tags\n\nRun `jote tags`. This provides a `fzf`-like interface of all known tags, showing\nthe associated documents for each tag. Select a tag and the interface will\nswitch to a list of those documents, allowing you to select one for editing.\n\n## Future features\n\n- An opinionated way for syncing to a git remote, allowing for editing across\n  machines. For now, this can be managed through manual git commands in the\n  repository.\n- Outputting results of tag searches to stdout as a list, for consumption by\n  other CLI tools.\n- More advanced searches by content.\n- Support a 'publish' keyword in the front matter. This could then be used by\n  plugins to format and send documents to configured consumers.\n- Deleting notes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjhuntwork%2Fjote","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjhuntwork%2Fjote","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjhuntwork%2Fjote/lists"}