Agent FAI now lives in your terminal

FAI CLI

Think with Agent FAI. Operate with precision.

Bring Agent FAI intelligence into your terminal. Switch seamlessly between Agent FAI CLI for grounded, conversational guidance and Operator CLI for precise, deterministic execution.

Explore Agent FAI CLI Explore Operator CLI

Agent FAI · live terminal

███████╗
██╔════╝
█████╗  
██╔══╝  
██║     
╚═╝

  █████╗ 
 ██╔══██╗
 ███████║
 ██╔══██║
 ██║  ██║
 ╚═╝  ╚═╝

  ██╗
  ██║
  ██║
  ██║
  ██║
  ╚═╝

FrootAI · Agent FAI CLI

LIVE · Grounded FrootAI intelligence · Embedded in terminal

Agent FAI [answer|observe]>

SSE answers stream as they arrive observe-only by default

Agent FAI CLI · intelligence in the terminal

Ask for an outcome. Leave with the right Agentic OS.

Agent FAI CLI is the terminal counterpart to Agent FAI web chat. It is designed to use the shared Agent FAI intelligence service and maintained FrootAI knowledge plane; the CLI adds terminal sessions, deterministic output, offline discovery, and a governed Play installer.

01 · Install

One package, two terminal experiences

npm install -g frootai@latest

FrootAI CLI is one stable npm package combining Agent FAI's conversational intelligence with deterministic Operator commands for exploring, building, validating, and shipping FAI solutions. The @latest tag installs version 6.3.2 with all three entry points: frootai, fai, and agent-fai.

Open Agent FAI package

02 · Sign in and start

Use one FrootAI account

frootai login --api-key
fai agent

Create a key in Account → API keys, then paste it at the hidden prompt. frootai agent and agent-fai are exact equivalents. Use “FAI,” not “Phi.”

03 · Ask or install

Begin with the outcome

I want to build smart agriculture.

Agent FAI recommends Play 78. Confirm in the conversation, or use /install-play 78.

Two clients

Web chat + terminal

The browser uses its account session. The CLI uses a hidden-input account API key.

Private account boundary

Identity + quota protection

The canonical account API validates identity, quota, and conversation ownership before every private Agent FAI request.

Shared intelligence plane

One private Agent FAI

Web and CLI reuse the same grounded intelligence and maintained FrootAI knowledge without exposing the underlying hosting topology.

One FrootAI account: browser session for web chat, account API key for CLI, shared private intelligence and knowledge.Open Agent FAI web chat

Agent FAI · PowerShellPREVIEW

PS C:\projects\farm> fai agent

███████╗
██╔════╝
█████╗  
██╔══╝  
██║     
╚═╝

  █████╗ 
 ██╔══██╗
 ███████║
 ██╔══██║
 ██║  ██║
 ╚═╝  ╚═╝

  ██╗
  ██║
  ██║
  ██║
  ██║
  ╚═╝

FrootAI · Agent FAI CLI

LIVE · Grounded FrootAI intelligence · Embedded in terminal

Agent FAI [answer|observe]>

help me build smart agriculture

⠹ Agent FAI is grounding and thinking…

BEST STARTING POINT

Play 78 · Precision Agriculture Agent

IoT Hub · AI Vision · OpenAI · Digital Twins · ML

EXPLORE

https://frootai.dev/solution-plays/78-precision-agriculture-agent

NEXT ACTION · /install-play 78

completed · remote thread saved for resume

Agent FAI [architecture|observe]>

Ask naturally

Describe the solution you want to build.

Match the Play

Packaged intelligence recommends the closest canonical architecture.

Inspect the proposal

See services, complexity, destination, source revision, and exact files.

Confirm explicitly

Only yes applies. Blank, ambiguous, cancelled, and declined responses do nothing.

Build with Copilot

Installed agents, prompts, skills, instructions, hooks, and workflows guide implementation.

Agent FAI CLI Installer

A Copilot-ready kit, installed atomically

For Play 78, the candidate verifies and installs 23 canonical files from one immutable commit and tree. An existing .github directory is never merged or overwritten silently.

agents

instructions

prompts

skills

hooks

workflows

copilot-instructions.md

Agent FAI · live terminal tour

01 / 04

Ask naturally

LIVE

$ fai agent

Agent FAI [architecture|observe]>

Design a secure enterprise RAG platform.

Understanding outcome and constraints…

✓ Intent: architecture

✓ Authority: observe only

Conversational intelligence, directly in your shell.

02 / 04

Ground every answer

LIVE

$ fai agent ask "Which Play fits?"

Recommended: Play 01 · Enterprise RAG

Grounding

01 Solution Play architecture

02 Enterprise search guidance

03 FAI security instructions

✓ 5 verified sources · citations ready

Maintained FrootAI knowledge, sources, and usage evidence.

03 / 04

Install the Agentic OS

LIVE

$ /install-play 78

Play 78 · Precision Agriculture Agent

23 canonical files · immutable source

Install .github into this project? [y/N]

yes

✓ identities verified

✓ installed atomically

✓ ready for GitHub Copilot

Verified first. Confirmed by you. Installed atomically.

04 / 04

Automate safely

LIVE

$ fai agent run --stdin --format jsonl

{"type":"turn.accepted","authority":"observe"}

{"type":"model.delta","content":"Review…"}

{"type":"usage.receipt","grounded":true}

{"type":"turn.completed","exitCode":0}

Offline discovery also available

fai agent ask "build agriculture" --offline

One governed interface for people, scripts, and CI.

Terminal surface

Chat, install, inspect, and automate

Use fai agent in documentation and everyday work. The longer frootai agent and direct agent-fai forms resolve through the same governed dispatcher.

Startfai agent

Open an interactive Agent FAI session.

Askfai agent ask "Which Play fits my use case?"

Run a single terminal question.

Install/install-play 78

Prepare and confirm the recommended Play kit.

Inspectfai agent context inspect --reference src/server.ts

Apply local trust and content controls.

Automatefai agent run --prompt "Review this change" --format jsonl

Stream events into automation.

Offlinefai agent ask "build smart agriculture" --offline

Search packaged public knowledge without network access.

Capabilities

What Agent FAI CLI includes

Stable 6.3.2 includes secure first-run API-key guidance, local tools, live private turns through the canonical account API, account allowance enforcement, and the complete Operator CLI in one npm package.

Interactive terminal chat

Included

A bounded thinking animation bridges first-token latency, then multi-turn SSE output streams into the terminal with cancellation and durable remote-thread resume.

Terminal-native presentation

Included

Markdown headings become readable sections, Mermaid becomes an arrow flow, and links move into a numbered clickable footer.

Shared Agent FAI intelligence

Included

Online terminal and web turns reuse the same private Agent FAI service and maintained FrootAI knowledge plane.

Grounded FrootAI knowledge

Included

Answers can use the maintained product, primitive, Solution Play, accelerator, and documentation knowledge plane.

Solution Play recommendation

Included

Describe an outcome and receive the closest packaged Play, why it fits, absolute website links, and safe next actions before installation.

Agent FAI CLI Installer

Included

A clear confirmation installs one canonical .github Agentic OS atomically.

Source protection

Included

Commit, tree, path, file size, and Git blob identity are verified before installation.

Workflow modes

Included

Switch between answer, architecture, plan, and review without increasing execution authority.

Automation and offline

Included

Use text, Markdown, JSON, JSONL, stdin, or explicit offline Play discovery.

Silent autonomous changes

Excluded

No silent overwrite, shell, deployment, or publication authority.

Implementation evidence

Connect a Play to a concrete Solution Accelerator.

Use accelerator evidence when the architecture needs an implementation starting point, then continue in the VS Code workbench.

Browse accelerators Open VS Code page