FOMIO CLI · GETTING STARTED

Five quiet minutes to your first Byte.

This page takes you from nothing to reading and posting on Fomio from your terminal: install, sign in, look around. A Byte is a post on Fomio—you'll open one before the end of this page.

Before you install

You need Node.js 20 or newer. Check with:

node --version

If that prints v20 or higher, you're ready. If not, install Node.js from nodejs.org first.

The CLI keeps your sign-in session in your computer's own keychain—the same secure storage your other apps use. For almost everyone this just works; only some Linux setups need one small package first.

macOS

Nothing to do. Keychain access is built in.

Windows

Nothing to do. The keychain connector installs automatically.

Linux

Most distributions need one runtime library—no compiler required:

# Debian / Ubuntu
sudo apt install libsecret-1-0

# Fedora / RHEL
sudo dnf install libsecret

Install the beta

npm install -g @fomio/cli@beta

Fomio CLI is in open beta: it works, and it's still settling. If something feels rough, that's useful to us—tell us in updates.

Check the install worked:

fomio --version

Sign in

fomio login

Here's what happens, so nothing surprises you:

1. Your browser opens to Fomio's sign-in page—the same safe place you always sign in.
2. You sign in there (or create an account if you're new).
3. The browser hands you back to the terminal. Done.

The CLI never sees or stores your password. Your session is kept in your computer's keychain, and nothing else is saved. To confirm who you're signed in as:

fomio whoami

Your first five commands

Three words to know, then you know the whole place: a Byte is a post. A Teret is a community where Bytes live. A Hub groups related Terets on one theme. That's the entire vocabulary.

# See what's worth reading right now
fomio feed

# Open a Byte by its number (shown in the feed)
fomio byte 113

# See every Hub and the Terets inside them
fomio hub

# Find anything—Bytes, Terets, people
fomio search "slow software"

# Say something back
fomio reply 113 -m "This found me at the right time."

That's the heart of it. The full list of commands—posting new Bytes, liking, bookmarking, preferences—is on the commands page.

Or skip the commands entirely

Run fomio with nothing after it and the terminal becomes a full reading room—browse with j and k, open things with enter, press ? anytime to see what keys do. If you'd rather wander than type commands, start there: interactive mode.

Signing out

fomio logout

This removes your session from the keychain completely. Signing back in is one fomio login away.