CLI Commands
All commands support the --pretty flag for human-readable colored output. Without it, output is JSON.
Authentication
Section titled “Authentication”notebind auth
Section titled “notebind auth”Store your API key for future requests.
notebind auth --token nb_sk_YOUR_KEYWithout --token, prompts interactively.
Saves the key to ~/.config/notebind/config.toml.
Project management
Section titled “Project management”notebind init
Section titled “notebind init”Initialize a .notebind/ directory in the current folder.
notebind initCreates .notebind/manifest.toml which tracks the mapping between local files and remote document IDs.
notebind link
Section titled “notebind link”Link a local file to an existing remote document.
notebind link article.md DOC_IDAdds the mapping to .notebind/manifest.toml:
[documents]"article.md" = "DOC_ID"notebind status
Section titled “notebind status”Show sync state of all linked documents.
notebind statusDocument operations
Section titled “Document operations”notebind push
Section titled “notebind push”Push a local markdown file to the platform.
notebind push article.md- If the file is already linked to a document, updates the existing document
- If not linked, creates a new document and adds the mapping to the manifest
notebind pull
Section titled “notebind pull”Pull a document with all its feedback (comments + suggestions) as JSON.
notebind pull DOC_IDIf only one document is linked, the ID is optional:
notebind pullnotebind list
Section titled “notebind list”List all documents on your account.
notebind listSharing
Section titled “Sharing”notebind share
Section titled “notebind share”Create a share link for a document.
notebind share DOC_ID --permission comment| Flag | Default | Values | Description |
|---|---|---|---|
--permission | comment | view, comment, edit | Permission level |
Feedback
Section titled “Feedback”notebind comments
Section titled “notebind comments”List unresolved comments on a document.
notebind comments DOC_IDnotebind suggestions
Section titled “notebind suggestions”List pending suggestions on a document.
notebind suggestions DOC_IDnotebind resolve
Section titled “notebind resolve”Resolve a comment.
notebind resolve DOC_ID COMMENT_IDnotebind accept
Section titled “notebind accept”Accept a suggestion (applies the text replacement to the document).
notebind accept DOC_ID SUGGESTION_IDnotebind reject
Section titled “notebind reject”Reject a suggestion (marks as rejected without modifying the document).
notebind reject DOC_ID SUGGESTION_IDGlobal flags
Section titled “Global flags”| Flag | Description |
|---|---|
--pretty | Human-readable colored output instead of JSON |
--version | Show version number |
--help | Show help for any command |