Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

68 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Mewbo logo

Mewbo

An open stack for agentic work, grounded in your own knowledge.

Ask DeepWiki Build and Push Docker Images Lint Docs Codecov GitHub Release Docker Image

Agentic task automation, memory-graph documentation and Q&A, and search across every tool you connect. Any model, open source.

🧭 Overview

Mewbo is an open stack for putting long running agents to work across enterprise systems, each one bounded, auditable and scoped to the person it runs for. Hosted assistants limit what connects and building past them takes engineering, so operators wait or move that data into an unapproved tool.

Whoever owns lead routing can put enrichment behind a schedule or a webhook. A support manager can stand up a live view over systems they already use without filing a ticket. Engineering gets the same session for a refactor or a migration, and anyone can ask a repository a question instead of reading it.

Permissions resolve ahead of the run rather than call by call, from the roles, teams and workspaces an owner defines. Every model call writes to one trace with token counts, so an audit answers who ran what and a failed step shows up instead of passing as done.

The wiki, the search, the apps and the task runner all run on one harness, so an improvement to the loop reaches all of them.

✨ Features

Agentic tasks

A long run is a fleet, not a chat. Approve the plan, then watch the tree and steer or stop any branch. Authority only narrows going down. Retries and model fallback absorb the failures, and one trace makes the result reviewable rather than merely finished.

Docs β†’

A Mewbo task in the web console. The request asks for trending repositories in an organisation to be visualised as a widget ranked by 30 day star growth, and an inline widget renders a ranked card grid of six repositories with language, star count and star delta

Agentic Wiki and Q&A

Indexing lifts a repository's ASTs into a three layer memory graph, so pages are generated from structure rather than from a file by file read. Probe agents traverse the same graph at question time, and a cross module answer arrives cited to a path and line range.

Docs β†’

A generated MewboWiki page titled Mewbo Architecture Overview, showing a layered package architecture diagram, an on this page outline rail, an index freshness card reporting that the newest index attempt did not finish, and the Ask MewboWiki composer with a model picker and a Fast mode toggle

Agentic Search

No single index spans the systems that hold your answer. Attach them as APIs, databases or MCP servers, and probe agents route by a graph of reachability rather than content, each writing its route back.

Docs β†’

Agentic Search results for a question about how a self hosted CI fleet splits between runners and control plane. A synthesis card cites three sources with a confidence score, twelve ranked results follow across Code and Web filters, and a right rail shows the agent trace with a coordinator and two probe sub-agents reporting steps, duration and tokens

Agentic Apps

The same harness builds an app against a structured playbook, then verifies it. Its frontend ships as WASM and runs in the browser sandbox, so you operate no new service. Triggers and schedules come out of the same build, so upkeep ships with the app.

Docs β†’

A live Mewbo App called LLM Model Compare. A filter rail on the left narrows by provider, release year, capabilities, intelligence index, throughput and blended cost. The centre shows stat tiles and a bar chart ranked by coding score. A right rail reports health, recent runs, daily pipelines, cron schedules and versions

Plugins and automation

Plugins add skills, agent definitions, hooks, session tools and MCP servers to a session. Triggers start one with nobody watching, on a schedule, on CI, on a pull request or on a webhook.

Plugins β†’ Β· Triggers β†’

Two Mewbo settings panes side by side. The left lists installed plugins with the skills, agents, commands, hooks and MCP servers each one contributes. The right lists reverse invocation triggers filtered by kind and status, each with its cron expression, fire count and next fire time

Mewbo Assistant on Android

The Android client runs the same sessions you have at your desk, registered as the device assistant so its orb answers over whatever app is in front of you. Voice goes in, and device tools act on the phone itself.

Docs β†’

Two Android phones running the Mewbo Assistant side by side, each showing the chat composer as a request is typed and sent

Also in the box:

  • Open agent standards. Agent Skills, agent definitions and MCP servers load exactly as written, so what you already run elsewhere works here unchanged. Marketplaces ship all three.
  • Identity and access. Principals, roles, teams, grants and an audit trail, with OIDC, LDAP and SAML behind their own extras. Every agent action lands against a real identity, so an audit can answer who ran what.
  • Sandboxed execution. A shell command is an opaque string, so Landlock confines the subprocess itself rather than trusting its arguments. On by default.
  • Plan mode and permissions. Approve the plan before anything runs. After that every write and every shell call clears a permission rule or a hook.
  • Agent hypervisor. A spawn past the concurrency ceiling comes back rejected rather than queued, so a saturated fleet is visible instead of silent.
  • Long-horizon context. Compaction summarises older turns as the budget fills and restores the working set afterwards. Fork any message to replay that branch on a different model.
  • Tracing and token accounting. Every model call writes a paired event onto the transcript and the session groups into one trace, with token counts split between the root agent and its children.
  • Code intelligence. Language servers are discovered automatically and rerun diagnostics after every edit, so a run sees the same errors your editor would.
  • Web IDE. Each session can open its own code-server container, started on demand and reaped when its time to live runs out. Take the files over mid-run without leaving the browser.
  • Any provider, every surface. Bring the models you already pay for. The terminal, the console, Android, the REST API, an MCP server, Home Assistant, Nextcloud Talk and email all drive the same session.

πŸš€ Get started

See docs.mewbo.com/latest/getting-started to install Mewbo and run a first session.

πŸ“š Documentation

Full documentation lives at docs.mewbo.com.

Section Covers
Get Started Install, configure a model, run a first session.
Terminal The terminal client, its interface, the agent fleet view, remote sync.
Web Console sessions, search and wiki, the Web IDE, panels, widgets.
Android Install, voice, chat and sessions, device tools.
Agentic Apps Building an app, and living with one once it runs.
API Building a client, structured outputs, automation, triggers, REST reference.
Client Integrations MCP server, Home Assistant, email, Nextcloud Talk.
Knowledge & Discovery Agentic Wiki and Agentic Search.
Capabilities Built-in tools, worktrees, code intelligence, sub-agents, skills, plugins, plan mode, permissions, compaction.
Deploy Docker Compose, storage backends, production setup, observability.
Configure Model setup, project setup, identity providers, configuration reference.
Develop Architecture, session runtime, Python reference.
Troubleshooting Symptom to cause to fix for common failures.
Releases Release notes and upgrade history.

🀝 Contributing

Bugs and feature requests on the issue tracker. For the architecture and the engineering rules a change is held to, see the architecture overview and CLAUDE.md.

πŸ“„ License

MIT Β© Krishnakanth Alagiri.

About

🌼 AI stack centered on an agent hypervisor. Automates tasks, graph-powered repo wiki, and Q&A, and searches across all your connected tools. Access it from browser, terminal, or API.

Topics

Resources

Stars

37 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages