Skip to main content

ffyi

CLI for friends.fyi.

Install

uv tool install ffyi

Installed commands: ffyi and fyi (alias).

Get a token

fyi login

Verifies GitHub ownership via a one-time gist. Creates a new account on first run; issues a fresh token for returning users. The command shells out to gh to create the verification gist and delete it after — fully non-interactive, no copying URLs around. Your username is taken from the gist owner. The returned API key is saved to ~/.config/fyi/token.

If you already have a token, store it directly:

fyi auth <token>
fyi whoami

Send

fyi send alice "hello"
echo '{"status":"ok"}' | fyi send alice --sender "Deploy Bot"
fyi send alice '{"status":"ok"}' --type alert -H "X-Env: prod"

Inbox

fyi inbox
fyi inbox --sender "Deploy Bot" --user-agent fyi-cli --type alert
fyi inbox <message-id>           # read a single message
fyi inbox --json

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ffyi-0.4.0.tar.gz (12.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ffyi-0.4.0-py3-none-any.whl (9.9 kB view details)

Uploaded Python 3

File details

Details for the file ffyi-0.4.0.tar.gz.

File metadata

  • Download URL: ffyi-0.4.0.tar.gz
  • Upload date:
  • Size: 12.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.10 {"installer":{"name":"uv","version":"0.11.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ffyi-0.4.0.tar.gz
Algorithm Hash digest
SHA256 d698d212958a7e5386dfef58fd222973d31dfa145f01857bfb97df9944e3615a
MD5 fa9cdbdb1f0e388c199ae1c6ced9828c
BLAKE2b-256 378a6840ba89e8a6c9bed0bbea75f15a861ff67d0956b846e7fc5b08ef26aba2

See more details on using hashes here.

File details

Details for the file ffyi-0.4.0-py3-none-any.whl.

File metadata

  • Download URL: ffyi-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 9.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.10 {"installer":{"name":"uv","version":"0.11.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for ffyi-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b7788b74931534ba29c44ecf51e88a44afce38995b234d97d72586b25995b1b8
MD5 1ccd61c4085f295c38c1ab88a7bc46ba
BLAKE2b-256 635dc1fe0512df45d4ed6a9dea4ac069b21a92a814826d6f8a8238860fc29db1

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.4.0 This release

2 files

0.3.0

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page