Google Keep frontend for terminals.
keep-cli is not supported nor endorsed by Google.
This is alpha quality code - take care if using in production! Feel free to open an issue if you have questions, see any bugs or have a feature request. PRs are welcome too!
pip install google-keep-cli
- Terminal based UI for Google Keep
- Subcommands for viewing and editing notes
- Import/Export notes from/to markdown
Configuration is stored in the ~/.keep. A config file is automatically created if one doesn't already exist, but you can inspect config.example.yml for an example.
To get a list of commands:
$ keep -h
If you want to manage and view notes via the TUI interface:
$ keep tui
Press ? to see a list of keyboard shortcuts in this mode
find: Get the IDs of all notes that match the specified criteria
get: View data from a note
set: Update data from a note
sync: Manually trigger a sync (this is typically unnecessary)
import: Import markdown files into Keep
export: Export notes to markdown files
A sync is performed automatically prior to every command. This is useful for simple usage, as it ensures that the data is up to date, but can be slow if performing a large number of actions. To work around this, pass the --offline flag to operate on the local cache and then flush all changes with a manual sync.
Example:
$ keep sync
$ keep --offline set --note id1 --text One
$ keep --offline set --note id2 --text Two
$ keep --offline set --note id3 --text Three
$ keep sync
There are still many missing/incomplete features:
- Search
- Saving a search
- Views
- View management (Edit/Delete)
- Kanban view
- Scrolling support
- Editing
- Label management (Add/Remove)
- Color picker
