I built a tiny offline AI agent that does boring file chores. The first one's free.

Description and use

Pocket-agent is a local AI agent that automates simple file operations without cloud calls, ensuring no hallucinations and safe writes.

Problem

Automate simple file operations without cloud APIs or hallucinations.

Outcome

Pocket-agent performs file chores locally, avoiding hallucinations and ensuring write integrity.

Workflow

• Install pocket-agent v7 tarball
• Run the agent with a file‑chore prompt
• Agent selects a deterministic tool (copy, append, move, grep, replace, list)
• Agent executes the tool and writes output
• Agent verifies write success before reporting completion

Evidence

pocket-agent is a tiny Python agent that runs entirely on your machine. A 1.5B Qwen model via llama-cpp. No API key, no cloud calls.

Source

It does boring file jobs: copy, append, move, pull matching lines out of a file (a deterministic grep), find-and-replace, list a directory.

Source

The trick: the small model never retypes your content. It only chooses which deterministic tool to run, so it can't hallucinate your text.

Source

It refuses a second write to the same path, refuses empty text, and only reports done when the goal‑completing write survived.

Source