Kipple
This is a management system for all the tools out there that support a healthy intellectual life. Unlike most knowledge management tools, Kipple doesn't assume that you want to be some kind of transhumanist of the mind. It just wants to help you think, remember, iterate, and move data around between systems.
Installation
The usual way:
npm install -g kipple
Note that on some platforms, since Kipple relies on your local keychain to store passwords, you may
need to install libsecret
. See keytar for details.
Support
Currently, the systems that Kipple can interact with are:
- Roam Research
- Evernote
- LibraryThing
- Zotero
- Google Drive
The operations that Kipple can carry out are:
- Logging in
- Pulling notes
- Pushing new notes
- Updating notes
- Converting between systems
- Linking between systems
- Running cron or event-driven tasks
Managing accounts
Kipple needs various credentials for each system that it integrates with. Those credentials will get stored in your local keychain for safekeeping.
There are variables that Kipple uses:
system
: the system being interacted with. Values include:roam
.account
: the account being used with that given system. Eg.robin@berjon.com
,robinberjon
.password
: the password for that account. You know what a password looks like.source
: some systems will have multiple different sources, which may be different databases, notebooks, paths… This allows picking one.
kipple login <system> <account> <password>
This will add a login that Kipple memorises for future use. It will update your password if the account already exists.
- For
roam
, this is your account name and password. - For
library-thing
, this is youruserid
and the JSON API key (the value given askey=
in the examples on that page).
kipple remove-login <system> <account>
Removes a login from Kipple. Note that this does not delete the data you may have locally.
Managing content
kipple add-source <system> <account> [source]
This simply includes a source in the list of sources that Kipple knows about. If the system does not
have multiple sources per account, then the source
argument is optional as there is only one for
that account. Note that this only adds it to the system, it does not download anything.
kipple remove-source <system> <account> [source]
Will remove a source, with the same parameters as add-source
. Note that this does delete
content.
kipple pull <system> [account] [source]
Pulls data from that source, overwriting the local content. If no source
is specified and there
are several known locally for that account
, it will do all sources in turn. If no account
is
specified, it will do all locally-known accounts in turn, and all locally-known sources in each of
them.