Ranch.Bot
Sign In

CLI release checked September 6, 2026

Livestock CLI and Assistant Setup

Read livestock records from your terminal with the public Ranch.Bot CLI. Sign in, select your farm, and use the same commands from a shell-capable assistant. Text-in and the web dashboard remain the standard setup for daily records.

Set up the CLI

The examples below read farm data. CLI writes run directly under your permissions, without the app confirmation screen or its Action-backed Change History.

  1. 01

    Install the CLI

    Use Node.js 22 or newer and an account with access to a Ranch.Bot farm.

    npm install -g @ranchbot/cli@1.0.0
  2. 02

    Sign in through your browser

    Open the URL printed by login, sign in, and approve the displayed code. No API key is needed.

    ranchbot login
  3. 03

    Select your farm and read animals

    Check your identity, list farms, then replace <farm_id> with the farm you want to use.

    ranchbot whoami --json
ranchbot farms list --json
ranchbot farms use <farm_id>
ranchbot animals list --json
Read the CLI setup guide

External integration status

CLI availability, MCP publication, and hosted connections are separate. A released CLI does not establish a supported integration with any individual assistant client.

Public CLI package
Released: 1.0.0
Install @ranchbot/cli with Node.js 22 or newer. Browser login uses OAuth, with no API key.
MCP package and Registry
Not published
The local stdio implementation remains a source-development path.
Hosted MCP endpoint
Not available
ChatGPT web and Gemini have no hosted Ranch.Bot connection.
Read MCP integration statusHTTP API reference and access guidance

Common questions

Can a shell-capable assistant use Ranch.Bot today?

Yes, an assistant allowed to run local shell commands can use the published Ranch.Bot CLI after you sign in. This is not a verified integration with any individual assistant client.

Does Ranch.Bot connect to ChatGPT or Gemini?

No public connection is available today. Ranch.Bot does not run the hosted MCP endpoint required by web assistants such as ChatGPT and Gemini.

Do I need an outside assistant to use Ranch.Bot?

No. Complete the short web setup, enable Text-in, text notes from the registered phone, and review proposed records in the Ranch.Bot web dashboard.

What is available to install?

The public @ranchbot/cli 1.0.0 package requires Node.js 22 or newer. The MCP package and Registry listing remain unpublished.

Where does review before saving apply?

The Ranch.Bot app and SMS workflow show proposed writes for review before they run. CLI writes run directly under your server permissions, without the app review screen or its Action-backed Change History. Review write commands before letting an assistant run them.

More setup help

For everyday records, follow the SMS and web setup guide. For assistant instructions, read the public agent skill.