Repository navigation
Releases
v0.10.0
Start in your terminal, continue from your phone. /sessions now lists the sessions you started on your computer for the project (marked 💻) and continues them with full context; /handoff takes a chat session back to the terminal.
Install or upgrade: go install github.com/c0sm0thecoder/pocketagent/cmd/pocketagent@latest. Archives are signed; see Verifying a release.
Added
- Continue sessions from your computer:
/sessionsnow also lists the agent's own sessions for the project folder, including ones started in a terminal (marked 💻), and continues them with full context. Supported for Claude Code (from its session logs) and for ACP agents that implement session listing. /handoff, and a line in/status, give the terminal command to continue the chat's current session on your computer (Claude Code).- Agent contract: optional
SessionListerandResumeHinterinterfaces.
v0.9.1
Fixed
- In groups, the bot replied "Not authorized" to Telegram's own service messages (for example "topic created", which Telegram posts as the bot), so every new topic got that message. Service messages and messages from bots are now ignored.
- Strangers in a group are now ignored silently; the "Not authorized" hint with the user id is only sent in private chats.
- Messages from an admin posting with "Remain anonymous" can't be attributed to a user, so they never run anything; the bot now explains how to fix it instead of staying silent.
v0.9.0
One topic per project. Turn a Telegram group into a workbench: each project gets its own topic, with its own agent, folder and session, working in parallel like terminal tabs.
Get started: go install github.com/c0sm0thecoder/pocketagent/cmd/pocketagent@latest, run pocketagent init (it now finds your projects), then follow Take off in five minutes. Archives are signed; see Verifying a release.
Added
- Project discovery:
pocketagent initnow has a Projects step that suggests folders from your code directories (~/projects,~/code, ...) and from where your agents ran recently, and/topicswith no projects (or the new 🔎 Find projects button in/project) offers the same suggestions as buttons, including "Add all and create topics". Agent history locations are data (Claude Code and Codex today); folders are de-duplicated by identity, so case-insensitive file systems don't show duplicates, and subfolders fold into their project unless they are their own git repo. initends with the recommended group setup, and/startexplains it.- README: a "Take off in five minutes" section built around the one-topic-per-project workbench.
/topicscreates a forum topic for every project (or the named ones) in a group with Topics, binds each topic to its project and posts a short welcome. Projects that already have a topic are skipped.
v0.8.0
Install or upgrade: go install github.com/c0sm0thecoder/pocketagent/cmd/pocketagent@latest, or download an archive below. Archives are signed; see Verifying a release.
Added
/project add [name] [path]registers an existing folder as a project from chat, and the/projectpicker offers "➕ Add this folder"./project remove <name>forgets one. Chat-added projects live in the state file; projects in the config file take precedence and can't be removed from chat.- The
/projectpicker shows each project's folder.
v0.7.0
The first public release. pocketagent lets you drive any coding agent from your phone: text, voice and images, with tap-to-approve, /diff and /undo.
Install: go install github.com/c0sm0thecoder/pocketagent/cmd/pocketagent@latest or download an archive below, then run pocketagent init. Archives are signed; see Verifying a release.
Added
- Quality gate shared by git hooks and CI (
make check): golangci-lint with gosec, actionlint with shellcheck, hadolint, race tests with coverage thresholds, govulncheck, gitleaks over the full history, module tidiness and cross-builds. - CodeQL, dependency review, OpenSSF Scorecard and Dependabot.
- Unit tests for the ACP and Claude Code adapters (against fake agents), the Telegram frontend, speech providers, the store and the CLI. Library coverage is now 80%.
- Community files: code of conduct, issue and pull request templates.
- Fuzz tests for the Markdown-to-HTML converter, message splitting, argv expansion and the config parser.
- Signed releases: Sigstore signature on the checksums and GitHub build provenance for every archive (see SECURITY.md).
make vulnalso scans every development tool binary; tools are built with the same pinned Go toolchain.
Changed
- Go 1.26.8 (Go 1.25 is out of support and had 13 reachable standard-library vulnerabilities).
- Container images: Go 1.26, Node 24 LTS, numeric user, base images pinned by digest.
Fixed
- The tool server had no timeouts.
- The whisper model download could keep a truncated file.
- ACP: a failed mode switch (for example to plan mode) was ignored silently; it is now reported.
- ACP:
Closepanicked when called twice. - systemd unit:
PATHwith spaces broke the service. - Close errors on written files are now checked (CodeQL).
v0.6.0
Breaking changes
pocketagent is now vendor-neutral. Update your config:
| before | after |
|---|---|
agents.<name>.type: claude |
type: claude-code |
transcriber.type: openai, tts.type: openai |
type: http, with base_url and model (and voice for tts) now required |
defaults.mode: yolo |
defaults.mode: full |
auto_allow, approval_timeout |
permissions.auto_allow, permissions.timeout |
adapter keys (model_args, stdin, ...) |
unchanged, but now checked strictly per adapter |
There is no implicit default agent any more: list at least one under agents: (or run pocketagent init). pocketagent doctor reports anything that no longer loads.
Also
- Each agent gets its own tool namespace on the tool server.
- Fix:
{placeholders}typed in a prompt were expanded inside command templates.
Changelog
- b6571a8 Refactor to a vendor-neutral, interface-driven architecture
v0.5.1
Changelog
- b7309ee Fix container images: reuse the node image's uid 1000 user
v0.5.0
Changelog
- 84be637 Add init wizard and doctor
- 3b8302f Add service install/uninstall for launchd and systemd
- 2416ebf Add start/stop/restart/status/logs and a single-instance lock
- 10e9c7e Fix /stop right after a message being ignored
- 86141ff Fix ACP cost: report per-turn spend, reset on new session
- 9a0ab2e Publish a container image to GHCR and a Homebrew cask
v0.4.0
Changelog
- d364629 Add sandboxing: wrap any agent in a container