# mini-agent

> The AI agent that sees before it acts — perception-driven, file-based, pluggable personal AI agent framework

- **URL**: https://www.freshcrate.ai/projects/mini-agent
- **Author**: miles990
- **Category**: Frameworks
- **Latest version**: `v0.1.0` (2026-03-10)
- **License**: MIT
- **Source**: https://github.com/miles990/mini-agent
- **Language**: TypeScript
- **GitHub**: 2 stars
- **Registry**: github
- **Tags**: `ai-agent`, `ai-framework`, `autonomous-agent`, `cli`, `llm-agent`, `perception`, `personal-agent`, `self-hosted`, `typescript`

## Description

The AI agent that sees before it acts — perception-driven, file-based, pluggable personal AI agent framework

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.1.0` | 2026-03-10 | Medium | ## What is mini-agent?  A perception-driven AI agent framework. Most agent frameworks are goal-driven — give it a task, get steps back. mini-agent **observes your environment first**, then decides whether and how to act.  Shell scripts define what the agent can see. Claude decides what to do. No database, no embeddings — just Markdown files + shell scripts + Claude CLI.  ## Key Features  - **Perception-First Architecture** — OODA loop (Observe → Orient → Decide → Act). Shell plugins define sense |

## Citation

- HTML: https://www.freshcrate.ai/projects/mini-agent
- Markdown: https://www.freshcrate.ai/projects/mini-agent.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/mini-agent/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._