Skip to main content

Welcome to loaf

A terminal-first AI coding assistant that brings powerful AI models, extensible tools, and custom skills directly to your command line.

Get StartedExplore Tools

Quick start

Get loaf running in your terminal in minutes

1

Install dependencies

Clone the repository and install dependencies:
git clone https://github.com/veyzyn/loaf.git
cd loaf
npm install
2

Start loaf

Run loaf in TUI mode:
npm run dev
On first launch, loaf will guide you through onboarding to connect AI providers.
3

Connect a provider

Choose from multiple AI providers:
  • OpenAI: OAuth login for ChatGPT models
  • OpenRouter: API key for access to 200+ models
  • Antigravity: OAuth for additional model access
Follow the onboarding prompts to authenticate.
4

Start chatting

Once authenticated, you can:
  • Ask questions and get AI assistance
  • Execute shell commands with the bash tool
  • Read and edit files with read_file and apply_patch
  • Run JavaScript code with run_js
  • Use skills with $skill-name syntax
Type /help to see all available commands.

Key features

Everything you need for AI-powered terminal development

Multi-provider support

Connect to OpenAI, OpenRouter, or Antigravity. Switch models on the fly.

Powerful tools

Built-in bash, file operations, JavaScript execution, and web search.

Skills system

Load repeatable instruction bundles with simple $skill-name syntax.

Background processes

Run long-running shell and JavaScript processes in the background with PTY support.

RPC API

JSON-RPC 2.0 stdio server for programmatic integration.

Custom tools

Author your own JavaScript tools and load them automatically.

Explore by topic

Find what you need to build with loaf

Slash commands

Master loaf’s command interface with /auth, /model, /history, and more.

Learn commands

Shell execution

Run shell commands with persistent state, PTY support, and background mode.

Explore bash tool

Custom tools

Author JavaScript tools that extend loaf’s capabilities.

Build tools

RPC integration

Integrate loaf into your tools with JSON-RPC 2.0 over stdio.

View API

Ready to get started?

Install loaf and start building with AI in your terminal today.

View quickstart guide

Build docs developers (and LLMs) love

Get started for freeTalk to us