Overview: what is PoAgent
PoAgent is a Windows desktop app that combines chat with AI models and an autonomous agent that works with your files, commands and servers right on your computer.
The app is portable: no installation required, all data lives in a data/ folder next to the exe.
Two modes in one window
- Chat — a full AI client: multiple conversations, streaming replies, Markdown with syntax highlighting, LaTeX formulas, Mermaid diagrams, HTML previews, Ctrl+V screenshots, attachments and vision (image input).
- Agent — an autonomous loop: give it a task and the agent plans the steps, reads files, makes edits, runs commands, verifies the result and fixes errors — then reports back.
What else PoAgent can do
- Notes — save reply fragments into a personal library.
- AI profiles — switch between models and providers in one click.
- Prompt snippets — ready-made roles (translator, copywriter, architect, teacher, analyst) plus your own templates.
- Servers — connect to your machines over SSH: commands and file transfer.
- Cloud sync — profiles and settings sync across computers via your license key.
- One-click updates — the app checks for, downloads and launches new versions itself.
Safety and reliability
- Approval gate — the agent runs dangerous actions (commands, file deletion, SSH) only after you approve them in a chat card. Full access is a 24-hour trust session: you can revoke it any time, and every action is journaled.
- Edit guard — before writing, the agent verifies the file still parses correctly (JS/JSON/CSS plus text-file structure). A breaking edit is rejected with an explanation instead of silently corrupting your files.
- Guaranteed stop — the Stop button kills the whole agent process tree (detached children included); nothing keeps running in the background.
- Revert — every edit has a snapshot; the change-log and
revert_filetools restore a file in seconds. - Diagnostics — a settings tab with the crash log and native crash dumps for quick troubleshooting.