Kanako Yasaka portrait by わんどろいど

kanako (神奈子)

The infinitely adaptable password manager, written in pure Bourne Shell.
Named after one of the Moriya Shrine gods, Kanako Yasaka from Touhou 10: Mountain of Faith

Supported backends

Setting it up

  1. Copy kanako.conf.example to ~/.config/kanako/kanako.conf and edit accordingly, there are all sorts of examples for each backend supported.
  2. Create ~/.kanako and ~/.kanako-store with mkdir -p, the former stores your key pair, the latter your password store.

Using the password store

Listing all existing entries

$ kanako -l

|--- Git
|    |--- github.com
           |--- password
           |--- username

Showing entries

$ kanako -v Git/github.com/password

Copying entries to the clipboard

You need to uncomment the proper fields to use either xclip or wl-copy.
Note: Complete support for Wayland is not a goal.

kanako -c Git/github.com/password

Adding entries to the store

You have to set $EDITOR, if unset, the default is vi

$ kanako -n Social/mastodon.social/password
<editor screen omitted for brevity>

Removing entries from the store

You can remove them one at a time, with -r, or recursively, with -R.
Both ways require that rm supports the -i and -I flags, respectively.


Both ways contain a typical Makefile and an mkfile (if you like to use Plan 9’s mk(1) instead), which should just work.

Git repository

You can browse the git repository or clone it:

$ git clone https://git.chaotic.ninja/yakumo.izuru/kanako

Extensions for kanako


See the manual pages

Credit & License

kanako was written by Izuru Yakumo of chaotic.ninja.

This program and the extensions are licensed under the Beerware License (Revision 42.1) – based on Poul-Henning Kamp’s license

 * ----------------------------------------------------------------------------
 * "THE BEER-WARE LICENSE" (Revision 42.1):
 * <yakumo.izuru@chaotic.ninja> wrote this file. As long as you retain this notice you
 * can do whatever you want with this stuff. If we meet some day, and you think
 * this stuff is worth it, you can buy me a bottle of sake in return Izuru Yakumo
 * ----------------------------------------------------------------------------

Generated with aya 0.6.0@aaf177d