Alpha · local-first · Ollama

A local coding agent with explicit authority.

local-agent is an alpha terminal coding agent for Ollama. Inspect repositories, edit files, run commands, and call MCP tools in NORMAL; enforce read-only work in PLAN; or send proactive work in AUTO. Start bounded durable goals explicitly with /goal.

Mutating effects require approval by default.

Get started Read the safety boundary GitHub

Trust boundaryLocal-first validates endpoints. It is not an operating-system sandbox.

An illustrative NORMAL session. Tool effects stay visible before they run.

Inference: Ollama
Authority: NORMAL · PLAN · AUTO
Extensions: MCP · expert teams
Platforms: macOS · Linux

Host-enforced modes

Authority is a mode, not a suggestion.

The host decides which tool surface exists. Changing modes changes real execution policy, not only the wording sent to the model.

Understand modes and goals

NORMALInteractive work

Inspect the repository, edit files, run commands, use memory, and call MCP tools. Mutating effects require approval by default.

read · edit · shell · memory · MCP

PLANRead-only analysis

Explore, search, compare, recall, or request a tool-free expert consultation. The host removes mutation tools and rejects mutation attempts.

read · search · diff · recall · experts

AUTOProactive work

Send ordinary prompts directly with proactive access to the NORMAL tool surface. AUTO does not create a durable goal or skip approvals.

proactive prompt · same approval policy

Live Ollama inventory

The model list comes from the runtime.

local-agent reads Ollama’s authoritative inventory, groups local and Cloud entries, and routes automatically only among admitted local models.

See installed weights and Cloud aliases in one picker.
Inspect capabilities and runtime details before switching.
Pull a model through a cancellable form.

Explore Ollama models

OLLAMAAvailable models

/api/tags

LOCAL

qwen3.5:4beligible for automatic routing

ready

LOCAL

qwen3.5:2bcompact installed tier

ready

CLOUD

Ollama Cloud aliasmanual selection only

Readable effects

See the request, the decision, and the receipt.

By default, repository mutations, shell commands, memory changes, and MCP calls require an explicit decision. Durable goals use the same policy.

Decisions stay visible.

When approval is required, the card keeps the tool and its arguments together before execution.

toolbash

go test ./... -racewaiting for decision

Allow once: one request
Allow exact request: current Agent process
Deny: stop this request

Durable goals stay bounded and foreground.

Start a goal explicitly with /goal. Its objective, limits, permits, receipts, and recovery remain visible as it advances.

Authority: goal-owned AUTO · same approval policy
Budgets: time · turns · evaluation tokens
Persistence: permits · receipts · recovery
Advisor: Cortex, when reachable

Cortex can provide bounded semantic status. local-agent still owns the approvals, transcript, budgets, and final stop decision.

Inspect the boundary

Local-first is precise, not absolute.

01
Ollama and network MCP endpoints must use local-machine addresses under local-only policy.
02
Built-in file tools canonicalize paths; external reads require a temporary exact-file or directory grant, while writes stay in the startup workspace.
03
Approved shell commands and trusted STDIO servers remain separate trust decisions.

Read the full safety model

Focused local tools

One host. A wider local-first toolchain.

Connected integrations, test infrastructure, and related projects keep separate ownership boundaries. MCP-capable does not mean bundled or silently trusted.

Goals and MCPCortex · MCPHubOptional advisor and recommended gateway

Context and stateVecgrep · VecLite · TinyVault · file.cheapRelated search, storage, and secrets tools

EvidenceGlyphrun · Cairntrace · VidtraceTerminal, browser, and recording evidence

OperationsMonitor · BobRelated observation and repository tooling

Explore the ecosystem

Start in a clean worktree

Bring the agent to where your code already lives.

Install the current tagged release, connect Ollama, and begin with a read-only request.

Install with Gogo install github.com/abdul-hamid-achik/local-agent/cmd/local-agent@latest

Follow the quickstart Review the source