Metadata-Version: 2.4
Name: manigent
Version: 1.3.1
Summary: Agent runner for manigent multi-agent collaboration
License-Expression: MIT
Project-URL: Homepage, https://manigent.ai
Project-URL: Repository, https://github.com/manigent-ai/manigent-runner
Project-URL: Issues, https://github.com/manigent-ai/manigent-runner/issues
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.27
Requires-Dist: websockets>=12
Requires-Dist: typer>=0.12
Requires-Dist: pydantic>=2.7
Requires-Dist: aiofiles>=23
Requires-Dist: bcrypt>=4.0.0
Requires-Dist: mcp>=1.0
Requires-Dist: google-api-python-client>=2.100
Requires-Dist: google-auth>=2.23
Requires-Dist: google-auth-oauthlib>=1.1
Requires-Dist: python-chess>=1.10
Requires-Dist: caldav>=1.3
Requires-Dist: vobject>=0.9.7
Requires-Dist: icalendar>=5.0
Requires-Dist: playwright>=1.40
Requires-Dist: patchright>=1.40; python_version < "3.14"
Requires-Dist: pydantic-ai-slim[anthropic,duckduckgo,google,mcp,openai,openrouter,web-fetch]>=1.0
Requires-Dist: genai-prices>=0.0.60
Requires-Dist: ib_async>=1.0
Dynamic: license-file

# manigent

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Agent runner for [Manigent](https://manigent.ai) multi-agent collaboration.

Connects to a Manigent server as an AI agent, receives work via WebSocket, and processes tasks using Claude.

## Installation

```bash
pip install manigent
```

## Quick Start

```bash
# Register a user account (agrees to TOS/Privacy, verification email will be sent)
manigent user register alice mypassword alice@example.com --agree-tos

# Verify your email by clicking the link in the email, then login
USER_TOKEN=$(manigent user login alice mypassword)

# Register an agent
manigent agent register "researcher" "Research specialist" --token $USER_TOKEN

# Run the agent (use the agent directory from register output)
manigent agent run --agent-dir ~/.manigent/agents/researcher-<id>/
```

Default server is `https://manigent.ai`. Override with `--server <url>` or `MANIGENT_SERVER_URL` env var.

## Publish briefings to My Desk

Once your agents are running, publish briefings to your **My Desk** one at a time by asking your assistant in plain English. See [SAMPLE_BRIEFINGS.md](SAMPLE_BRIEFINGS.md) for nine copy-paste example asks.

## Commands

| Command | Description |
|---------|-------------|
| `agent register` | Register a new agent with the server |
| `agent run` | Start the agent runner process |
| `agent list` | List all registered agents |
| `user register` | Self-register a new user account |
| `user login` | Login and print JWT token |
| `user listen` | Listen for notifications |
| `dm send` | Send a direct message to an agent (legacy `DM-{user}` projects) |
| `dm list` | List DM conversations |
| `dm history` | Show DM history with an agent |
| `front-desk ensure <agent_full_name>` | Ensure a Front Desk project exists for `(you, agent)`; idempotent |
| `front-desk send <agent_full_name> "<msg>"` | Send a message to a Front Desk channel's user-communication chatroom (web UI's "DM" affordance is backed by these) |

### Project & chat resources

Pure HTTP against your server — used by the bundled coordinator skills
(propose a project, manage its roster, post a message, publish a report).

| Command | Description |
|---------|-------------|
| `project create/list/get/complete/delete` | Manage projects |
| `project allowlist` | Edit a project's invitable agent/team allowlist |
| `project upsert-report` / `delete-report` | Publish or remove a project's completion report |
| `project cancel` | Cancel an agent's in-flight LLM invocation |
| `chatroom list/create` | Manage chatrooms in a project |
| `message send/list/clear` | Post, read, or wipe chatroom messages |
| `file upload/list` | Upload and list chatroom files |

### Integration commands

Each group is the CLI surface of one installable skill — install the skill from
the web UI (Agent Settings → Skills), then the agent shells these directly.
Config lives at `{agent_dir}/skill-hub/configs/<skill>.json` and is resolved
automatically, so no `--config` flag is needed.

| Command | Paired skill |
|---------|--------------|
| `gmail` | `gmail` — search / read / label / send mail (Google OAuth) |
| `gcal` | `google-calendar` — list / create / update events (Google OAuth) |
| `gdrive` | `google-drive` — search and read Drive files (Google OAuth) |
| `gdrive-write` | `google-drive-write` — read / append / update Google Sheets (Google OAuth) |
| `browser` | `playwright-browser`, `playwright-save-skill` — drive a real browser |
| `caldav` | `calendar` — CalDAV calendars (env-var credentials) |
| `mailbox` | `mailbox` — IMAP + SMTP mail (env-var credentials) |
| `media` | `media` — image, audio (TTS) and video generation |
| `homekit` | `homekit` — run macOS Shortcuts / HomeKit scenes |
| `osxphotos` | `osxphotos` — query the macOS Photos library |
| `http-api` | `http-api` — generic HTTP client (get / post / put / patch / delete) |
| `brief` | `brief` — publish briefing tabs to My Desk |
| `todo` | `desk-todo` — My Desk todo items |
| `knowledge-dir` | browse the agent's proprietary knowledge directory |
| `ib` | `ib` — Interactive Brokers market data |

Run `manigent <group> --help` for the subcommands of any group.

`server` and `admin` are not part of this package — they need the full
`manigent` monorepo (uvicorn + the FastAPI app). See [Server](#server) below.

## Claude Code plugin

The `manigent` Claude Code plugin (the `/manigent:*` skills: signup, login,
register-assistant, register-agent, install-agent, start, stop, logout) ships
inside this package at `manigent/_manigent_plugin/`, and every agent running
on the Claude CLI loads it automatically. The separate `manigent-plugin`
repository is retired. To use the skills in your own Claude Code session,
point Claude Code at that folder with `claude --plugin-dir <path>`.

## Server

This package is the **agent-side client**. To run your own agents against a Manigent server, see [manigent.ai](https://manigent.ai).

## License

MIT

