Skip to content

marioidival/limit

Repository files navigation

Limit Logo

Limit

License: MIT Crates.io

AI pair programmer that lives in the terminal.

Edit files, run commands, analyze code, manage git — all through natural language. Supports Claude, OpenAI, z.ai, and local LLMs.

Install

# One-line
curl -fsSL https://raw.githubusercontent.com/marioidival/limit/trunk/install.sh | bash

# Or via Cargo
cargo install limit-cli

Requirements

Platform Architecture Binary
Linux x86_64 lim-linux-x86_64
Linux aarch64 (ARM64) lim-linux-aarch64
macOS aarch64 (Apple Silicon) lim-macos-aarch64

From source: Rust 1.70+, git, Unix-like OS (Linux, macOS)

Quick Start

# 1. Configure
echo 'provider = "anthropic"' > ~/.limit/config.toml
export ANTHROPIC_API_KEY="your-key"

# 2. Run
lim

Features

Feature Description
Multi-Provider Anthropic Claude, OpenAI, z.ai, Ollama, LM Studio, vLLM
16 Tools File I/O, Bash, Git, AST-aware code search, web search, browser automation
AST Search Structural code matching with ast-grep (Rust, TypeScript, Python)
Session Persistence Auto-save/restore conversations
Docker Sandbox Optional isolated execution
TUI + REPL Beautiful terminal UI or simple text mode

Configuration

Create ~/.limit/config.toml:

# Anthropic (recommended)
provider = "anthropic"
[providers.anthropic]
model = "claude-sonnet-4-6-20260217"

# OpenAI
# provider = "openai"
# [providers.openai]
# model = "gpt-5.4"

# Local (Ollama, LM Studio, vLLM)
# provider = "local"
# [providers.local]
# model = "llama3.3"
# base_url = "http://localhost:11434/v1/chat/completions"

Environment variables: ANTHROPIC_API_KEY, OPENAI_API_KEY, ZAI_API_KEY

Tools

Core

Tool Description
file_read Read files (max 50MB)
file_write Write files
file_edit Diff-based edits
bash Execute shell commands

Git

Tool Description
git_status Repository status
git_diff Show changes
git_log Commit history
git_add Stage files
git_commit Create commit
git_push / git_pull Sync with remote
git_clone Clone repository

Code Analysis

Tool Description
ast_grep AST-aware search (Rust, TS, Python)

Web & Browser

Tool Description
web_search Search the web (Exa AI)
web_fetch Fetch pages as markdown
browser 46+ automation actions

Commands

Command Description
/exit Save and exit
/clear Clear screen
/help Show commands
/model Show config
/session list List sessions
/session new New session
/share Export session (clipboard/md/json)

Optional Dependencies

Tool Feature Install
Docker Sandbox isolation docker.com
ast-grep AST search brew install ast-grep

Crates

Crate Description
limit-llm Multi-provider LLM client
limit-agent Agent runtime with tool registry
limit-tui TUI components
limit-cli TUI/REPL interface

Documentation

License

MIT

About

Limit is your AI coding companion that refuses to leave the terminal — and that's exactly where it belongs.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors