Noute CLI

Bring Noute into
your command line.

Open notes, search spaces, create, append, move, and publish — all from Terminal. No separate install.
Download NouteSee commands
Terminal

$ noute spaces

# Spaces

- Work — /Users/me/notes/work

- Research — /Users/me/notes/research

$ noute append ~/notes/work/daily.md "Follow up with design"

Appended text to /Users/me/notes/work/daily.md

$ noute config publish

# Publish settings

Context without clicks

Open a single note, a whole space, a deep link, or the browser on a published URL.

Readable by humans and agents

Output defaults to Markdown, with JSON available when a script needs structured data.

Quick edits when you need them

Append, prepend, or move notes without a separate API, sync service, or automation layer.

Command surface

Built for shell workflows.

A small, useful command set: open paths, create notes, list spaces, search, append and prepend, move notes, configure and run publish, plus deep links.

Basics

Open the right thing, fast.

Point Noute at a file or folder and it opens directly. Force a fresh window when a workflow needs it.

Open help

noute --help

Open a note

noute ~/notes/today.md

Open a space in a new window

noute open -n ~/notes/workspace

Headless

Search from scripts, shortcuts, and agents.

Output defaults to readable Markdown, with `--format json` when a script needs structured data.

List spaces

noute spaces

List spaces as JSON

noute spaces --format json

Search current workflow

noute search "meeting notes"

Search a specific space

noute search "roadmap" --space ~/notes/work --limit 10

Write

Update notes from shell scripts.

Append or prepend content, or move a note. Pass text inline or pipe stdin from another command; `mv` creates parent folders as needed.

Append a quick note

noute append ~/notes/work/daily.md "Follow up with design"

Prepend from stdin

printf "## Inbox\n- [[Roadmap]]" | noute prepend ~/notes/work/project.md

Move a note

noute mv ~/notes/inbox/draft.md ~/notes/work/weekly/draft.md

Publish

Ship notes and folder sites to the web.

Inspect Cloudflare R2 settings from the shell, publish a file or folder, then check status, republish, delete, or open the live URL.

Read the publish template guide

Show publish configuration

noute config publish

Publish a note or folder

noute publish ~/notes/work/readme.md

Publish status (no changes)

noute publish --status ~/notes/work/site

Automation

Link shell flows back into the app.

Deep links, note creation, JSON output, and `publish --open` make Noute easy to trigger from launchers and agent workflows.

Open from a deep link

open 'noute://open?file=/Users/me/notes/today.md'

Create a note in a space

noute new --space ~/notes/work --title "Standup"

JSON for tooling

noute search "cli" --format json

Open published URL in the browser

noute publish --open ~/notes/work/readme.md

Install

One app. One install. One workflow.

Noute installs the CLI from the desktop app as a symlink into `/usr/local/bin`. No extra package manager step.

01

Download Noute

Install the macOS app first. The CLI ships with Noute — no separate package to manage.

02

Run Install CLI

Use the app menu or Command Bar to install the `noute` symlink into `/usr/local/bin`.

03

Stay in sync

The command points at the installed app, so when you update Noute the CLI stays current.

Download Noute and bring the CLI into your workflow.

Use Noute from the app when you want a calm writing surface. Use it from Terminal when you want to move faster.

Download nowAll builds