CLI Installation

The Notebind CLI (notebind) syncs markdown files between your local machine and the Notebind platform. It’s built in Rust for fast, reliable operation.

Installation

From crates.io

cargo install notebind

Requires Rust 2024 edition or later.

From source

git clone https://github.com/notebind/cli.git
cd cli
cargo install --path .

Verify installation

notebind --version

Initial setup

Authenticate
Terminal window
```
notebind auth --token nb_sk_YOUR_API_KEY
```
Or run without --token for an interactive prompt. The key is saved to ~/.config/notebind/config.toml.
Initialize a project

In your repository root:
Terminal window
```
notebind init
```
This creates a .notebind/ directory with a manifest.toml file that tracks file-to-document mappings.
Push your first file
Terminal window
```
notebind push README.md
```

Output format

By default, all commands output JSON for easy parsing by agents and scripts:

notebind list

[
  {"id": "doc-uuid", "title": "README.md", "updated_at": "2026-03-13T12:00:00Z"}
]

For human-readable colored output:

notebind list --pretty

Documents:
  README.md  (doc-uuid)  Updated: Mar 13, 2026