scrb

A fast CLI for capturing and syncing your thoughts — timestamped, searchable, and available anywhere.

scrb is built for people who want zero-friction thought capture right from their terminal. No menus, no lag, and no local note files left behind on shared university or work computers.

Quick Start

Installation

npm install -g scrb

Log In (Passwordless)

Log in once with your email. An OTP code will be sent to your inbox:

scrb login

Usage

Instant Capture

Just type your thought. No flags needed:

scrb "<thought>"

Multi-Line Notes (Vim / Notepad)

Open your terminal text editor to write longer markdown notes:

scrb new

Edit an existing note by its short ID:

scrb e <id>

View and Search Thoughts

scrb ls             # List recent thoughts
scrb s <keyword>    # Search thoughts
scrb get <id>       # View full note
scrb rm <id>        # Delete a note

Multi-Device Sessions and Privacy

scrb is designed so you can safely use it on university lab PCs, borrowed laptops, or work machines:

• Zero notes stored on disk: Your notes are fetched on-the-fly and never saved to the local machine's hard drive.
• See active computers:

  scrb sessions

• Remote Revoke: Forgot to log out of a computer? Revoke it from your own laptop:

  scrb kill <session-id>

  That machine is immediately locked out!
• Clean Logout:

  scrb logout

Commands Reference

| Command | Description | | :--- | :--- | | scrb "text" | Instant scribble (capture thought directly) | | scrb a <text> | Add a one-line thought | | scrb new | Write in your editor (vim / notepad) | | scrb e <id> | Edit an existing thought in your editor | | scrb ls | List recent thoughts with relative time | | scrb s <query> | Search thoughts by keyword | | scrb get <id> | View complete thought with date and time | | scrb rm <id> | Delete a thought | | scrb login | Log in with email OTP | | scrb logout | Log out and clean up this computer | | scrb whoami | View current logged in user and device | | scrb sessions | View all active logged in devices | | scrb kill <id> | Remotely revoke access from a device |

Running the Server (Self-Hosting)

To run your own sync API server:

# Clone the repository
git clone https://github.com/sumit0xff/scrb.git
cd scrb

# Install dependencies
npm install

# Start the API server
npm start

Point your CLI to your self-hosted server:

export SCRB_API_URL="http://localhost:3000/api/v1"

License

MIT (c) SUMIT0XFF