A minimal, extensible AI agent harness with a unified multi-provider LLM API, agent runtime, terminal UI, and a coding agent CLI.
SAFIYEV/HeyAgent
A local-first desktop AI agent that operates your Windows PC, browser, and files, controllable from the terminal, desktop app, or Telegram.
Open-source alternative to:Microsoft Copilot
Claude Computer Use
- Stars
- 52
- Forks
- 0
- Open issues
- 0
- Last commit
- 13 days ago
Key features
- 01Controls mouse, keyboard, windows, screenshots, and applications on the desktop.
- 02Automates browser tabs, including your real browser profile.
- 03Acts as a coding agent that edits, tests, and commits code in a chosen project folder.
- 04Connects Google Docs, Drive, Sheets, Slides, and Calendar via OAuth.
- 05Accepts tasks from a Telegram bot paired to your own chat.
- 06Supports cloud model providers and local Ollama models with failover.
Use cases
- Remotely running tasks on your Windows PC from your phone via Telegram.
- Automating repetitive desktop or browser workflows on your own machine.
- Letting an AI agent make and verify code changes in a local project.
- Generating Google Docs or spreadsheets from a natural-language request.
Topics
FAQ
- What is HeyAgent?
- A local-first desktop AI agent that operates your Windows PC, browser, and files, controllable from the terminal, desktop app, or Telegram.
- Is HeyAgent free to use? What license does it have?
- HeyAgent is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
- Is HeyAgent still maintained?
- Actively maintained. The last commit to HeyAgent was on Oct 6, 2026.
- What can I use HeyAgent for?
- Remotely running tasks on your Windows PC from your phone via Telegram. Automating repetitive desktop or browser workflows on your own machine. Letting an AI agent make and verify code changes in a local project. Generating Google Docs or spreadsheets from a natural-language request.
- Where can I get HeyAgent?
- The source code and installation instructions are on GitHub: https://github.com/SAFIYEV/HeyAgent
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Apache Maka (Incubating) is an agent workspace for desktop, TUI and CLI that records every model message, tool call and permission decision as an append-only event log.
An open source AI coding agent that runs in your terminal, with a desktop app and two built-in agents for building and planning changes.
An agentic coding tool from Anthropic that runs in your terminal, reads your codebase, and handles coding tasks and git workflows via natural language.
An open-source coding agent that reads your project, edits files and runs tests from your terminal, desktop, browser or editor.
An open-source coding and research agent built on a persistent Python REPL, with subagents, a self-refining harness, and support for long-running tasks.