@finnaai/matrix
v0.3.1
Published
Matrix OS command-line client — login, sync, and peer management for matrix-os.com
Readme
@finnaai/matrix
Command-line client for Matrix OS.
Install
# Homebrew (macOS/Linux)
brew install finnaai/tap/matrix
# npm
npm install -g @finnaai/matrix
# curl (auto-detects platform)
curl -sL get.matrix-os.com | shUsage
matrix login # device-code flow against app.matrix-os.com
matrix sync ~/matrixos # start the sync daemon against the logged-in instance
matrix run -it -- claude # attach local TTY to Claude on your Matrix VPS
matrix run -it -- codex # same shared zellij session primitive for Codex
matrix run -it --session setup -- gh auth login
matrix shell connect setup # reattach the same session from local CLI or web terminal
matrix peers # list connected peers
matrix logout # clear local credentialsAll three bin entries are installed: matrix, matrixos, mos.
Requirements
- Node.js 24 or newer
- A Matrix OS account — sign up at app.matrix-os.com
License
AGPL-3.0-or-later.
