Repolode
Submit
holaboss-ai

holaboss-ai/holaOS

Local-first agentic workspace where your apps, chat tools, integrations, memory and any agent (Claude Code, Codex, BYOK models) sit side by side.

View on GitHubWebsite
Stars
11,458
Forks
767
Open issues
10
Last commit
2 months ago

What is it?

holaOS is a desktop workspace for running AI agents alongside the apps and systems a team already uses. Users install interactive apps such as Notion, a browser, or a custom web app, and the agent operates them in a panel beside the chat, with changes made by hand visible to the agent as context.

The workspace connects to chat tools such as Slack, Feishu, DingTalk and WeChat, and to 50+ services through one-click OAuth. Any Model Context Protocol server can be added as a tool, and reusable skills and bundled "combos" can be shared. Claude Code, Codex and the built-in holaOS agent share the same tools, files and memory, and models can be used through a built-in account or your own OpenAI, Anthropic or compatible keys.

Memory, embeddings and session history are stored on the local disk as readable, editable files. The project is available as a desktop app for macOS, Windows and Linux, or can be self-hosted from source under a modified Apache 2.0 license.

Key features

  • 01Installable apps open as live interactive surfaces beside the agent.
  • 02Integrations with 50+ services via one-click OAuth, plus MCP server support.
  • 03Chat tool connections for Slack, Feishu, DingTalk and WeChat, with per-scope access control.
  • 04Shared local memory that persists across sessions and agents.
  • 05Works with Claude Code, Codex, or the built-in agent, and supports BYOK model providers.

Use cases

  • A team that wants an agent to work from real Slack or Feishu conversations instead of summaries.
  • Developers who want to run Claude Code and Codex over the same tools and files.
  • Self-hosting an agent workspace where company data stays on local machines.
  • Automating recurring reports, digests, or spreadsheets and slides as real files.

Quick start

  1. 1

    Check prerequisites (git, node, npm)

    git --version && node --version && npm --version
  2. 2

    Install desktop dependencies from the repository root

    npm run desktop:install
  3. 3

    Create your local environment file

    cp apps/desktop/.env.example apps/desktop/.env
  4. 4

    Prepare the local runtime bundle

    npm run desktop:prepare-runtime:local

Things to know

  • The license is modified Apache 2.0 rather than standard Apache 2.0, so check its terms before commercial use.
  • Full functionality depends on a holaOS account or your own model API keys.
  • The manual setup involves several steps and needs Node.js and npm installed.

Topics

#ai-agent#workspace#mcp#llm#electron#local-first#claude-code#typescript#agent#agent-harness

FAQ

What is holaOS?
Local-first agentic workspace where your apps, chat tools, integrations, memory and any agent (Claude Code, Codex, BYOK models) sit side by side. holaOS is a desktop workspace for running AI agents alongside the apps and systems a team already uses. Users install interactive apps such as Notion, a browser, or a custom web app, and the agent operates them in a panel beside the chat, with changes made by hand visible to the agent as context.
Is holaOS free to use? What license does it have?
holaOS is open source under the Other license. Check the license terms before using it in commercial products.
Is holaOS still maintained?
Updated within 6 months. The last commit to holaOS was on Aug 21, 2026.
What can I use holaOS for?
A team that wants an agent to work from real Slack or Feishu conversations instead of summaries. Developers who want to run Claude Code and Codex over the same tools and files. Self-hosting an agent workspace where company data stays on local machines. Automating recurring reports, digests, or spreadsheets and slides as real files.
How do I install holaOS?
Check prerequisites (git, node, npm): git --version && node --version && npm --version Install desktop dependencies from the repository root: npm run desktop:install Create your local environment file: cp apps/desktop/.env.example apps/desktop/.env Prepare the local runtime bundle: npm run desktop:prepare-runtime:local
Where can I get holaOS?
The source code and installation instructions are on GitHub: https://github.com/holaboss-ai/holaOS

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects