🚀 scout (FrontTerrain CLI)

FrontTerrain (scout) — The Agentic AI Engineering & Onboarding Co-Pilot for Codebases.

Scout works like GitHub Copilot directly inside your terminal — executing autonomous multi-step agentic loops, fixing bugs, creating new source code files, executing shell commands with AI failure diagnostics, scanning codebases, and running interactive AI chat.

📦 Installation

Install globally using npm:

npm install -g ft-scout@latest

⚡ Quick Start & Commands

Once installed, use scout or ft in any project directory:

🤖 Agentic AI Actions

# 🤖 Autonomous Multi-Step AI Agent (Modifies code, verifies tests/build, and self-heals failures)
scout agent "Add email input validation and ensure npm test passes"
scout task "Fix typescript build errors in src/utils" -v "npm run build"
scout goal "Refactor database query logic" -y

# ✨ Generate and create a new source code file
scout create src/utils/math.ts "Create helper functions for sum, average, and array chunking"
scout gen src/components/Header.tsx "Create a responsive React navigation header"

# 🛠️ Auto-fix code using AI based on prompt, target file, or scan issue ID
scout fix "Fix null pointer check in calculateTotal function"
scout fix -f src/sampleBug.ts "Handle optional prices defensively" -y
scout fix -i 1

# ⚡ Run terminal/shell commands with automated AI error diagnosis & self-healing
scout run npm test
scout exec tsc
scout run python main.py

# 💬 Interactive Agentic AI Chat session (with slash commands & action triggers)
scout chat
scout chat --web --lang spanish

# ↩️ Revert Scout's last action & restore backed-up file contents
scout undo

🔍 Codebase Understanding & Due-Diligence

# Initialize understanding map of a local or remote repository
scout init [repoUrl]

# Multilingual AI teardowns & onboarding summaries (e.g. spanish, hindi, french, japanese, etc.)
scout init [repoUrl] --lang spanish
scout init [repoUrl] -l hi

# Human-readable onboarding summary (the "week-one explainer")
scout brief

# Bug & code quality scan report (read-only)
scout scan

# Feasibility + step-by-step implementation roadmap for a new feature
scout add "Add rate limiting to API endpoints"

# Architecture, performance, and DSA-level suggestions
scout recommend

# Security & dependency / supply-chain audit
scout audit

# Show knowledge holders of a specific directory or file (from git history)
scout owners <path>

# Show a code fragility map based on churn and hotfixes
scout risky

# Live internet search for live web context & up-to-date documentation
scout search "Next.js 15 App Router"
scout web "Tailwind CSS v4" --ask --lang french

# History log of everything Scout has done in this repository
scout history

# Check for updates and auto-upgrade Scout
scout upgrade

✨ Key Capabilities

• 🤖 Autonomous Multi-Step AI Agent (scout agent / scout task / scout goal): Set a high-level engineering goal. Scout identifies target files, applies code changes, executes automated build/test verification scripts, and self-heals any compiler or test errors in a continuous autonomous loop.
• ✨ AI File Generation (scout create): Specify a file path and a requirement prompt. Scout generates clean, production-ready code, creates missing directories, and provides an interactive review prompt (Keep vs Revert).
• 🛠️ Prompt-Driven Auto-Fix (scout fix): Fix bugs and refactor code across single or multiple files. Scout analyzes the root cause, applies code edits, displays a technical explanation, and backs up original code.
• ⚡ Terminal Execution & Failure Diagnosis (scout run): Run tests, builds, or scripts directly. If execution fails, Scout analyzes stdout/stderr logs with AI, pinpoints the root cause, and offers to auto-fix the failing code automatically.
• 💬 Agentic Copilot Chat (scout chat): An interactive terminal session with Slash Commands (/agent, /create, /fix, /run, /read, /scan, /undo, /help) and natural language tool execution.
• ⚡ Non-Interactive / CI Auto-Confirm (-y, --yes): Skip interactive prompts and auto-confirm changes when running inside CI pipelines or scripts.
• ↩️ Safety & Instant Revert (scout undo): Every code modification or file creation is logged in .ft/history.json with file backups, allowing instant restoration anytime.
• 🌐 Multilingual Teardowns & Web Search (scout search): Access live internet documentation and generate breakdowns in 20+ languages.

📄 License

ISC © FrontTerrain

⚠️ Model decommissioning

• Notice: The llama-3.1-8b-instant model is scheduled for decommission on 2026-08-16. After that date, requests to this model will no longer be served. The CLI will skip or warn when this model is selected and fall back to available alternatives.