▲ Vertex CLI

Your knowledge, structured — from the terminal.

Vertex is a keyboard-first knowledge workspace. This CLI gives you full access to your notes, todos, tags, and search from the command line.

Install

npm install -g vertex-notes

Quick Start

vertex login          # Log in with GitHub, Google, or Email
vertex notes          # List all your notes
vertex today          # Open daily note in interactive mode
vertex capture "idea" # Quick capture to Inbox

Commands

Auth

| Command | Description | |---------|-------------| | vertex login | Log in (GitHub, Google, or Email) | | vertex logout | Log out and clear session | | vertex whoami | Show logged-in user |

Notes

| Command | Description | |---------|-------------| | vertex notes | List all notes | | vertex new [title] | Create a new note | | vertex view <title> | View note as markdown | | vertex edit <title> | Edit in $EDITOR (vim/nano/code) | | vertex daily | View or create today's daily note | | vertex daily --last | View the most recent daily note |

Interactive Mode

Open any note in a terminal UI with todo toggling:

vertex today                 # Latest daily note
vertex interactive <title>   # Any note

Controls:

| Key | Action | |-----|--------| | ↑ ↓ | Move between items | | Enter | Toggle todo done/undone | | t | Add new todo | | n | Add new text line | | d | Delete item at cursor | | s | Save changes | | q | Save and quit |

Capture & Search

vertex capture "buy groceries"           # Quick capture to Inbox
vertex search "keyword"                  # Full-text search
vertex search "#tag"                     # Search by tag
vertex search "type:todo status:open"    # Open todos
vertex tags                              # List all tags

Export

vertex export "Meeting Notes"            # Print as markdown
vertex export "Meeting Notes" --json     # Print as JSON
vertex export "Meeting Notes" -o out.md  # Save to file

Trash

vertex delete <title>    # Move to trash
vertex restore <title>   # Restore from trash
vertex trash             # List trashed notes
vertex trash:empty       # Permanently delete all

Info

vertex status    # Storage usage, note count
vertex help      # Full help with all commands

Editor Syntax

When using vertex edit, you write in markdown:

# Heading
**bold** *italic* `code` ~~strike~~
- Bullet list
1. Numbered list
- [x] Done task
- [ ] Open task
> Blockquote
[[Wiki Link]] #tagname

Code blocks, math blocks ($$ ... $$), and standard markdown all work. Rich blocks (mermaid, callouts, file uploads) require the web app.

Architecture

The CLI shares the same backend as the Vertex web app:

• Database: Supabase (PostgreSQL with RLS)
• Auth: Supabase Auth (GitHub, Google, Email)
• Storage: Cloudflare R2

Notes created in the CLI appear in the web app and vice versa.

Requirements

• Node.js 18+
• A Vertex account (sign up via vertex login)

License

MIT