A plain text note-taking assistant


Looking for a quick usage example? Let's get started.

News: We Are In Maintenance Mode

[!IMPORTANT] As of January 2nd, the original brain behind zk, Mickaël Menu, made the difficult decision to retire from zk and the suite of programs supporting it. He put out a call for maintainers, which has garnerned enough response to enable the project to continue! So zk is definitely still here for you.

During this transition phase, we are placing the project into a maintenance mode, which means we are going to address existing issues and any teething problems with transferring the code bases to the new zk-org organisation, which is where you can now find all the related projects. It also gives us new maintainers the space to get up to speed with the code base, which will help us address new issues and feature requests when they come.

So for now, feel free to lodge new issues, but please withold on feature requests until we are out of maintenance mode. This will help keep our issues boards concise and pr’s easier to manage.

The call to maintainers is still open. Please comment there if you feel commited enough to come onboard! PR’s, ideas, discussions and conversations are still and always will be warmly welcomed, with or without ‘maintainer’ status ❤️


zk is a command-line tool helping you to maintain a plain text Zettelkasten or personal wiki.


See the changelog for the list of upcoming features waiting to be released.

What zk is not


Check out the latest release for pre-built binaries for macOS and Linux (zk was not tested on Windows).


brew install zk

Or, if you want to the latest changes:

brew install --HEAD zk


# Run zk from Nix store without installing it:
nix run nixpkgs#zk
# Or, to install it permanently:
nix-env -iA zk

Arch Linux

You can install the zk package from the official repos.

sudo pacman -S zk

Build from scratch

Make sure you have a working Go 1.18+ installation, then clone the repository:

$ git clone https://github.com/zk-org/zk.git
$ cd zk

On macOS

$ make
$ ./zk -h

On Linux

$ make
$ ./zk -h