About Localagent
Localagent is an MCP server published by CalvinSturm in the Developer Tools category: local-first agent runtime for MCP workflows with explicit trust controls, replayable runs, and built-in evals.
The repository has 31 stars and 6 forks, with the last commit 2 months ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/CalvinSturm/LocalAgentThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Localagent
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 4 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
LocalAgent
Local-first agent runtime for MCP workflows with explicit trust controls and replayable runs.
LocalAgent helps you get from curiosity to a working local agent workflow without fighting provider setup, unsafe defaults, or opaque failures.
It is built for the hard part of local agents: connecting on-machine LLMs to MCP tools in a way that is guided, inspectable, and operationally clear.
Why LocalAgent
Most friction in local agents is operational.
LocalAgent narrows that gap with:
- guided startup and provider auto-detection
- interactive TUI chat for local agent workflows
- explicit trust controls with approvals and audit trails
- replayable artifacts and inspectable event logs
- safe defaults with shell and write access disabled unless explicitly enabled
- built-in eval workflows and reviewable run outputs
- a beginner-friendly path without hiding advanced controls
Quick start
Start a supported local provider, then launch LocalAgent in the project directory you want to work in.
# 1) Install from the repo root
cargo install --path . --force
# 2) Launch LocalAgent in the workspace you want to work in
localagent
If your provider starts after LocalAgent is already open, press R in the startup screen to refresh provider detection.
Supported providers
- Ollama
- LM Studio
- llama.cpp server
Common commands
One-shot task
localagent --provider ollama --model llama3.2 --prompt "Summarize src/main.rs" run
Interactive TUI chat
localagent --provider ollama --model llama3.2 chat --tui
Verify a provider
localagent doctor --provider ollama
localagent doctor --provider lmstudio
localagent doctor --provider llamacpp
Enable trust controls
localagent --trust on --provider ollama --model llama3.2 chat --tui
Enable shell and write tools only when you intentionally want side effects.
CLI note
Global flags come before subcommands. See the examples above and the CLI reference for full command syntax.
Safety model
LocalAgent is designed to make side effects explicit.
- shell and write access are disabled unless explicitly enabled
--allow-shell-in-workdiris a narrower shell mode than--allow-shell- trust mode can enforce policy and approvals
- persistent runs remain inspectable through artifacts and logs
The goal is not to remove every restriction. It is to make local agents usable without hiding risk.
Provider setup
Before running LocalAgent, start a supported local provider and make sure a model is available.
See: Provider setup
Installation
Build from source
cargo build --release
Binary output:
- Windows:
target/release/localagent.exe - Linux/macOS:
target/release/localagent
Install globally from source
cargo install --path . --force
Releases
Prebuilt binaries are available in GitHub Releases.
For full install, updates, Windows troubleshooting, and verification steps, see:
Docs
Getting started
Runtime internals
Runtime policy
Additional docs
Contributing
Issues, feedback, and contributions are welcome.
Start here:
License
MIT
README fetched from the repository 4 days ago. The original is authoritative.