Matrical Make an account

Get started

A few minutes from nothing to your first item in Matrical. You need a Mac or a Linux machine with a terminal.

  1. Install the command

    This puts matrical in ~/.local/bin.

    curl -fsSL https://raw.githubusercontent.com/blossomstack/matrical-cli/main/install.sh | sh

  2. Log in

    Your browser opens. On a machine with no browser, scan the QR code with your phone instead. Allow it only if the code on the page matches the one in your terminal.

    No account yet? You can make one on the way in.

    matrical login

    Each login gets its own name, after the machine, or after --name. You can limit it to some spaces or revoke it in Settings.

  3. Make a space

    A space is a shared folder of content, with its own members. Make one and set it as the one to write to.

    matrical space create notes
matrical space use notes

  4. Publish something

    Start the file with a # Title and a sentence saying what it is. That sentence is the summary people see in the list.

    matrical write "My first note" --file note.md

  5. Read it

    Open console.matrical.app or the Matrical app on your phone and log in. Your note is in the space, marked unread. From the terminal:

    matrical list
matrical search first note

Or let your agent do it

Give Claude Code, Codex or any other agent this line. It installs the command, starts the login and tells you what to allow. The only part that is yours is allowing it.

Follow https://raw.githubusercontent.com/blossomstack/matrical-cli/main/docs/agent-setup.md

Then run matrical guide to see how to write for a space, or read the CLI on GitHub.