# Zeno Agent

> Self-hosted personal agent.

- **Type:** MCP server
- **Install:** `agentstack add mcp-ribeirogab-zeno-agent`
- **Verified:** Pending review
- **Seller:** [ribeirogab](https://agentstack.voostack.com/s/ribeirogab)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ribeirogab](https://github.com/ribeirogab)
- **Source:** https://github.com/ribeirogab/zeno-agent
- **Website:** https://zeno-agent.dev

## Install

```sh
agentstack add mcp-ribeirogab-zeno-agent
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# zeno-agent

> Personal agent that operates across the apps you use, by composing the connectors you install. Self-hosted. Single-user.

[](./LICENSE)
[](./GOVERNANCE.md)
[](https://github.com/ribeirogab)

> [!WARNING]
> **Early / experimental.** Personal project, single-user, no SLA, no support guarantees. Breaking changes expected. Use at your own risk.

## What it does

Zeno acts on your behalf inside the apps you already work in. Open a pull request after fixing a Sentry error. Triage your inbox. List the issues blocking the current sprint. Comment on a PR with the output of a code review. Anything that involves *acting* in an external app, Zeno can do — provided you have installed a connector for that app. Connectors are the heart of the product: each one is a small MCP server you install through the dashboard. Without connectors, Zeno is a talking statue.

## Install

```bash
curl -fsSL https://zeno-agent.dev/install.sh | sh
```

The wrapper at `zeno-agent.dev/install.sh` forwards to the [`install.sh`](./install.sh) shipped at the most recent release tag; pass `| sh -s -- --unstable` to install from `main` instead. Full walkthrough — prerequisites, profile creation, first `@zeno hello` in Slack — at . Daily commands at .

## What works today

- **Channel:** Slack via Socket Mode (mention the bot or DM it). Worker boots without Slack creds and falls back to a `NoopChannel` so first install isn't blocked on the dashboard chicken-egg.
- **Connectors** (live in the dashboard catalogue at ): GitHub App, GitHub Personal (PAT), Linear, Klaviyo, Sentry, Swarmia.
- **Skills:** Markdown SKILL.md playbooks installed via the dashboard, materialized into `~/.claude/skills/`, auto-discovered by the Claude Agent SDK. Capabilities (Read/Edit/Write/Bash) are gated globally per profile.
- **Multi-profile isolation:** the `zeno` CLI manages N profiles via a host SQLite (`~/.zeno/state.db`); each profile is its own container, dashboard, master key, and credentials.
- **Per-tool capability gating:** toggle individual connector tools allow/ask/off from `/connectors/`.
- **Crons:** scheduled agent runs configured in the dashboard at `/crons`, persistent across restarts, with per-cron run history.

What is **not** here yet: no multi-user support (single operator only), no production-deployment recipe, no hosted instance.

## Project layout

```
apps/        worker (agent runtime), api (REST), dashboard, docs (Fumadocs site), web (landing), cli
packages/    @zeno/db (host SQLite), @zeno/storage (runtime SQLite), @zeno/logger,
             @zeno/ui, @zeno/github-app, @zeno/mcp-discover
agent/       SOUL.md, mcp.json, connectors-catalog.json (committed identity)
templates/   profile/ — read-only scaffolds the CLI uses on profile create
infra/       Dockerfile, entrypoint, slack-app-manifest.json
install.sh   one-shot installer (curl-pipe target)
.vault/       constitution + specs + learnings + conventions + rules
~/.zeno/     (off-repo) zeno-agent clone, state.db, profiles//
```

`AGENTS.md` is the agent's working contract. `.vault/_index/home.md` is the project's knowledge map. `.vault/constitution.md` carries the non-negotiable design principles. The outsider documentation site lives at .

## Contributing, security, license

- Roadmap: see [ROADMAP.md](./ROADMAP.md).
- Issues and pull requests: see [CONTRIBUTING.md](./CONTRIBUTING.md).
- Vulnerability reports: see [SECURITY.md](./SECURITY.md).
- Code of conduct: [CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md).
- License: [MIT](./LICENSE).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ribeirogab](https://github.com/ribeirogab)
- **Source:** [ribeirogab/zeno-agent](https://github.com/ribeirogab/zeno-agent)
- **License:** MIT
- **Homepage:** https://zeno-agent.dev

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ribeirogab-zeno-agent
- Seller: https://agentstack.voostack.com/s/ribeirogab
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.