Picocode

Picocode is an open-source, lightweight CLI coding agent built in Rust by Dotan Nahum (jondot). It provides a compact, native terminal harness for interacting with language models to execute code generation, scanning, and refactoring tasks directly from the command line. In daily use, Picocode operates through command-line inputs driven by declarative YAML configuration files. Developers can specify model providers, define tailored personas, pass file contents as contextual prompts, and run structured code inspection workflows without the overhead of heavy interactive environments. What differentiates Picocode from larger CLI frameworks is its minimalist Rust architecture and focus on customizable file-prompt workflows. Rather than packaging a complex TUI or heavy background runtime, it focuses on fast startup times, straightforward persona configurations, and reusable scanning skill definitions. Picocode is open-source software distributed via GitHub. It operates on a bring-your-own-key model where execution costs are determined entirely by your configured LLM API provider.

Tags: ai agent, cli, coding agent, developer tools, OpenSource

Visit Picocode

Key features

• Native Rust binary — Fast startup and execution with zero runtime dependencies beyond the compiled binary. - YAML configuration — Declarative configuration support via picocode.yaml for setting models, behaviors, and parameters. - Custom personas — Ability to define and swap system personas to tailor model responses for specific engineering tasks. - File-based prompting — Direct ingestion of local files and project context into model prompts from the CLI. - Scanner skill templates — Structured scanning capabilities using skill configuration files like picocode.scan-skills.yaml.

Use cases

Use Case: Automated Codebase Scanning Developers can run structured skill templates against source files to detect code smells, anti-patterns, or security oversights directly from the terminal. This allows teams to run targeted, prompt-driven audits locally or inside automated CI pipelines.

Use Case: Persona-Driven Code Refactoring Engineers can configure specialized YAML personas (such as idiomatic Rust developer or security reviewer) to execute targeted refactorings and code improvements on selected source files.

Use Case: Scriptable Shell Workflows Developers can incorporate Picocode into shell pipelines to pipe diffs, logs, or code context directly into an LLM and receive structured responses without needing a multi-pane TUI.

Who it is for

Picocode is suited for developers and DevOps engineers who want a lightweight, scriptable, Rust-based CLI agent with minimal setup and customizable YAML configurations. It is not designed for users seeking complex graphical terminal interfaces (TUIs) or interactive multi-agent chat workspaces.

Install guide

Installation Install using the automated installation script: bash curl -sSf https://raw.githubusercontent.com/jondot/picocode/main/install.sh | sh Alternatively, build the native binary from source using Cargo: bash git clone https://github.com/jondot/picocode.git cd picocode cargo build --release

First Run Set up your configuration and configure your model API key: bash cp picocode.yaml.example picocode.yaml export OPENAI_API_KEY="your_api_key_here"

Example Session Run Picocode with a prompt and a target source file: bash picocode --config picocode.yaml "Analyze this file for potential memory leaks" src/main.rs

Part of CLI Coding Agents

Categories: AI Coding Agents, Code Assistants, Developer Tools

Related CLI agents

• OpenCode — OpenCode is an open-source AI coding agent developed by Anomaly that operates across terminal environments, desktop applications, and IDE extensions.…
• goose — goose is an open-source, general-purpose AI agent built in Rust, hosted under the vendor-neutral Agentic AI Foundation (AAIF) at the…
• SWE-agent — SWE-agent is an open-source autonomous software engineering agent harness built and maintained by researchers from Princeton University and Stanford University.…
• OpenHands — OpenHands (formerly OpenDevin) is an open-source autonomous AI software development agent and orchestration platform. It provides an extensible runtime environment…
• Plandex — Plandex is an open-source terminal-based AI coding agent designed to handle complex, multi-file engineering tasks in large codebases. Created by…
• Weaver — Weaver is an open-source agent harness and orchestration framework maintained by sean35mm on GitHub. Built on top of the Bun…