NoteSane CLI

The official CLI for NoteSane - The Agentic Knowledge Workspace. Turn your terminal into a capture surface for your second brain.

Installation

npm install -g notesane

Usage

1. Login (Device Flow)

Authenticate securely with your NoteSane account without pasting API keys manually.

notesane login

Follow the on-screen instructions to authorize via your browser.

2. Capture Notes

Pipe logs, diffs, or thoughts directly into NoteSane.

# Capture text
echo "Fix authorization bug" | notesane capture

# Capture logs
npm run build 2>&1 | notesane capture --title "Build Log" --tag bug

# Capture with explicit arguments (ID, Slug, or Name)
notesane create "Refactor database schema" --tag backend --board backend-api
notesane create "Fix login bug" --board "My Workspace"

Options:

• -t, --title <string>: Set note title.
• --tag <strings>: Add tags (e.g. --tag dev bug).
• --board <id|slug>: Target a specific board by Slug, Name, or ID.
• --type <text|code>: Force note type (auto-detected if piped).

3. Context Awareness

Create a .notesane file in your project root to auto-tag all captures from that directory.

.notesane:

{
  "boardId": "your-board-id",
  "tags": ["work", "project-x"]
}

Configuration (Local Development)

By default, the CLI connects to https://notesane.com. To test against a local server, create a .env file or set the environment variable:

# .env
NOTESANE_API_URL=http://localhost:3000