Metadata-Version: 2.4
Name: agentops-mcp-server
Version: 0.4.9
Summary: Simple MCP server for AgentOps with Zed
Project-URL: Homepage, https://github.com/rioriost/homebrew-agentops_mcp_server
Project-URL: Issues, https://github.com/rioriost/homebrew-agentops_mcp_server/issues
Author-email: Rio Fujita <rifujita@microsoft.com>
License: MIT License
        
        Copyright (c) 2026 Rio Fujita
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Requires-Python: >=3.14
Provides-Extra: test
Requires-Dist: pytest-cov>=4; extra == 'test'
Requires-Dist: pytest>=7; extra == 'test'
Description-Content-Type: text/markdown

# Zed AgentOps

Zed AgentOps helps you run an edit → verify → commit loop inside Zed with an MCP server and a project scaffold designed for resumable agent work.

> Currently supported on macOS.

## What it does

- Scaffolds a project for AgentOps use in Zed
- Provides a local MCP server for repo, verification, and resume-oriented workflow helpers
- Adds a default `verify` entry point you can extend for your project
- Keeps enough local state for the agent to resume work more reliably across interrupted sessions

This README is written for users of the tool. Internal implementation details are intentionally kept to a minimum.

## Installation

Install with Homebrew:

```bash
brew tap rioriost/agentops_mcp_server
brew install agentops_mcp_server
```

This installs the `agentops_mcp_server` binary and `zed-agentops-init.sh`.

## Quick start

Initialize a new project directory:

```bash
zed-agentops-init.sh my_project
```

Update an existing AgentOps-managed directory:

```bash
zed-agentops-init.sh --update my_project
```

After initialization:

1. Open the directory in Zed
2. Register the MCP server in your Zed settings
3. Open the Agent Panel
4. Start working in the repo

## What initialization creates

Running `zed-agentops-init.sh` sets up the files you need to start using AgentOps in Zed:

- `.rules`
- `.zed/tasks.json`
- `.zed/scripts/verify`
- `.agent/tx_event_log.jsonl`
- `.agent/tx_state.json`

It also:
- creates a Git repository if one does not already exist
- appends common ignore entries to `.gitignore`
- preserves existing files when possible
- supports `--update` to refresh an existing setup

## Recommended Zed configuration

Add the MCP server to your Zed settings.

Minimal MCP server example:

```json
{
  "agentops-server": {
    "command": "/opt/homebrew/bin/agentops_mcp_server",
    "args": [],
    "env": {
      "PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"
    }
  }
}
```

If you also want to pre-allow commonly used AgentOps tools in the Agent Panel, your `settings.json` can include entries like this under your tool permissions:

```json
{
  "terminal": {
    "default": "allow"
  },
  "mcp:agentops-server:workspace_initialize": {
    "default": "allow"
  },
  "mcp:agentops-server:tx_event_append": {
    "default": "allow"
  },
  "mcp:agentops-server:tx_state_save": {
    "default": "allow"
  },
  "mcp:agentops-server:tx_state_rebuild": {
    "default": "allow"
  },
  "mcp:agentops-server:session_capture_context": {
    "default": "allow"
  },
  "mcp:agentops-server:repo_verify": {
    "default": "allow"
  },
  "mcp:agentops-server:repo_commit": {
    "default": "allow"
  },
  "mcp:agentops-server:repo_status_summary": {
    "default": "allow"
  },
  "mcp:agentops-server:repo_commit_message_suggest": {
    "default": "allow"
  },
  "mcp:agentops-server:tests_suggest": {
    "default": "allow"
  },
  "mcp:agentops-server:tests_suggest_from_failures": {
    "default": "allow"
  },
  "mcp:agentops-server:commit_if_verified": {
    "default": "allow"
  },
  "mcp:agentops-server:ops_compact_context": {
    "default": "allow"
  },
  "mcp:agentops-server:ops_handoff_export": {
    "default": "allow"
  },
  "mcp:agentops-server:ops_resume_brief": {
    "default": "allow"
  },
  "mcp:agentops-server:ops_start_task": {
    "default": "allow"
  },
  "mcp:agentops-server:ops_update_task": {
    "default": "allow"
  },
  "mcp:agentops-server:ops_end_task": {
    "default": "allow"
  },
  "mcp:agentops-server:ops_capture_state": {
    "default": "allow"
  },
  "mcp:agentops-server:ops_task_summary": {
    "default": "allow"
  },
  "mcp:agentops-server:ops_observability_summary": {
    "default": "allow"
  }
}
```

Adjust permissions to match your own security preferences.

## Typical usage flow

Once the project is initialized, the normal flow is:

1. Ask the agent to make a change
2. Let it run project verification
3. Review the result
4. Commit the change

The scaffolded verify script is the default entry point for checks:

```bash
.zed/scripts/verify
```

Extend it to match your repository. By default, it tries common checks for changed files, such as Python, Swift, Rust, shell scripts, and Bicep where the corresponding tools are installed.

## Release verification / coverage

For release-oriented Python coverage runs, use:

```bash
.zed/scripts/verify-release
```

This requires `pytest-cov` to be available.

## Updating from older versions

If you already use Zed AgentOps, run:

```bash
zed-agentops-init.sh --update <project>
```

This refreshes the user-facing scaffold, especially:

- `.rules`
- `.agent` state file presence
- default verify/task scaffolding where applicable

Recent versions also tightened resumability and state alignment, so updating is recommended before starting new work in an older scaffold.

## What changed in recent versions

### Current behavior summary

- The scaffold now aligns `.rules` with the current workflow expectations
- Initial transaction state starts from the current baseline
- Resume behavior is centered on the local AgentOps state files
- The default setup is aimed at safer interruption/resume cycles

### If you are upgrading from an older scaffold

You may notice:

- refreshed `.rules`
- refreshed initial state defaults
- improved consistency between the scaffold and the current runtime behavior

In most cases, `--update` is enough.

## Files you will commonly interact with

- `.rules` — project instructions injected into the agent context
- `.zed/scripts/verify` — your main verification entry point
- `.zed/tasks.json` — reusable Zed tasks
- `.agent/tx_event_log.jsonl` — local AgentOps event log
- `.agent/tx_state.json` — local AgentOps state used for resuming work

For most users, the important point is simple: keep `.rules` current by using the latest scaffold or running `--update`.

## Notes

- macOS only at the moment
- The generated scaffold is meant to be customized per repository
- The default verify script is intentionally conservative and may need project-specific additions

## License

MIT