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_file tools restore a file in seconds.
  • Diagnostics — a settings tab with the crash log and native crash dumps for quick troubleshooting.