FOMIO CLI · COMMANDS

Every command, one page.

A reminder of the three words you'll see everywhere: a Byte is a post, a Teret is a community where Bytes live, and a Hub groups related Terets. Every command below also answers to --help, e.g. fomio post --help.

Your account

Opens your browser to sign in to Fomio. No password ever touches the terminal; your session is kept in your computer's keychain. Already signed in? Running it again just refreshes your session.

fomio login

fomio whoami

Shows which account you're signed in with—useful when a command tells you to sign in and you're sure you already did.

fomio whoami

fomio logout

Signs you out and removes your session from the keychain completely.

fomio logout

Reading

fomio feed

Your front page. Two views: hot (what's worth reading right now) and latest (newest first). Hot is the default unless you change it with fomio config.

fomio feed            # your default feed
fomio feed --latest   # newest Bytes first
fomio feed --hot      # trending Bytes
fomio feed -i         # open the feed in interactive mode

fomio byte <id>

Opens one Byte and its replies. The number is shown next to every Byte in the feed and in search results.

fomio byte 113
fomio byte 113 --share   # also copies a shareable link to your clipboard

fomio teret <slug>

Opens a Teret—a community—and lists its Bytes. The slug is the short name shown under Bytes and in fomio hub.

fomio teret design

fomio hub

The map of the whole place: every Hub, and the Terets inside each one. Start here when you don't know where to look.

fomio hub

fomio user <username>

A person's profile and their recent Bytes.

fomio user layla

fomio search <query>

Searches Bytes, Terets, and people in one go. Quote multi-word queries.

fomio search "slow software"

Writing

fomio post

Publishes a new Byte. Tell it which Teret to post in, give it a title, and write the body—either inline with -m or in your editor, which opens automatically when you leave -m off.

# Write the body in your own editor
fomio post --teret design -t "The case for slow software"

# Or do the whole thing inline
fomio post --teret design -t "The case for slow software" -m "Some tools rush you…"

Common mistake: forgetting --teret. Every Byte lives in a Teret, so the CLI will ask for one if it's missing.

fomio reply <byteId>

Replies to a Byte. Same editor behavior as post: pass -m for a quick line, or leave it off to write in your editor.

fomio reply 113 -m "This found me at the right time."
fomio reply 113          # opens your editor for a longer reply

fomio like <byteId>

Likes a Byte. Quiet appreciation, one command.

fomio like 113

fomio bookmark <byteId>

Bookmarks a Byte so you can find it again later from your Fomio account.

fomio bookmark 113

Preferences

fomio config

Shows your CLI preferences: who you're signed in as and which feed is your default. One setting can be changed today:

fomio config                  # view current preferences
fomio config --feed latest    # make 'latest' your default feed
fomio config --feed hot       # back to 'hot'

Environment

Two optional environment variables, for people who want them:

variable	default	what it does
`EDITOR` / `VISUAL`	`vi` (or `notepad` on Windows)	Which editor opens when you run `fomio post` or `fomio reply` without `-m`. Interactive mode has its own built-in composer and doesn't use this.
`FOMIO_API_URL`	`https://meta.fomio.app`	Points the CLI at a different Fomio server—staging or self-hosted. Most people never touch this.

When something doesn't work

A command says you need to sign in. Run fomio login—your browser opens, you sign in, and you're back.
A Byte number isn't found. It may have been removed. Go back to fomio feed or fomio search and open it fresh.
You're offline. The CLI will tell you. Check your connection and run the command again.

next: interactive mode arrow_forward back to getting started