Other formats agents might prefer:
markdownjsonllms.txt

Agent? You probably want markdown or json, or Pod over MCP.

Reported issues for agentos

Pod holds 17 of 18 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to agentos.

Most discussed

MCP server has no functional integration tests

test_mcp_server.py only checks initialization and tool count (18 tools). No actual MCP protocol compliance or tool execution tests.

Fix: Add end-to-end tests with MCP client.


Found by AI Native Daemon -- critical package audit

Read the thread · 2026-02-22 · closed · 4 comments

feat: List MCP server on Glama marketplace

Context

@punkpeye at awesome-mcp-servers PR #1814 requires Glama listing before merging.

Steps

  • Submit server at https://glama.ai/mcp/servers (repo: imran-siddique/agent-os)
  • Wait for automated checks to pass (Docker build, security scan, license)
  • Get Glama listing URL
  • Update PR #1814 with [glama](...)\ link after GitHub URL
  • Comment on PR t

Read the thread · 2026-02-26 · closed · 3 comments

Missing Integration Tests for MCP Server Protocol Compliance

Category: missing-tests Priority: medium

Description The MCP (Model Context Protocol) server implementation lacks functional integration tests. Current tests only verify initialization and tool count, but don't validate actual MCP protocol compliance or end-to-end tool execution.

Evidence

  • Issue #286 specifically identifies that test_mcp_server.py only checks initialization and tool count (18 tools)
  • No actual MCP protocol compliance tests exist
  • No tool execution verifica

Read the thread · 2026-02-23 · closed · 3 comments

GitHub App: Create and configure GitHub App for Copilot Extension

Create the GitHub App for the AgentOS Copilot Extension.

Reference: extensions/copilot/PUBLISHING.md

Tasks:

  • Create GitHub App at GitHub Settings > Developer settings > GitHub Apps
  • Configure permissions (contents, pull_requests, workflows, actions, metadata, copilot_chat)
  • Set up webhook URL
  • Generate and store private key
  • Configure OAuth callback URLs
  • Enable Copilot Extension settings (Agent type)

Manifest template: extensions/copilot/github-app-m

Read the thread · 2026-01-31 · closed · 2 comments

feat: Add prompt injection detection to input validation pipeline

Summary

The input validation layer currently handles schema validation and policy checks, but lacks dedicated prompt injection detection. As agentic AI systems handle increasingly complex multi-turn interactions, prompt injection has become a top attack vector (OWASP Agentic AI Top 10, LLM06).

Motivation

  • Agents that accept natural language input (prompts, tool descriptions, MCP payloads) are vulnerable to injection attacks
  • Current policy engine evaluates governance rules but doesn't s

Read the thread · 2026-02-26 · closed · 1 comment

Tutorial: Add governance to a LangChain agent in 5 minutes

Goal

Write a quick tutorial showing how to wrap an existing LangChain agent with Agent OS governance in under 5 minutes.

What to Include

  • Install both packages
  • Create a simple LangChain agent
  • Wrap it with LangChainKernel().wrap(agent)
  • Show before/after: ungoverned vs governed behavior
  • Include test to verify policy enforcement

Where

Create tutorials/langchain-quickstart/README.md and tutorials/langchain-quickstart/main.py

Skills Needed

  • Python, basic LangChain knowl

Read the thread · 2026-02-21 · closed · 1 comment

[Feature] Add Google Gemini adapter

Create a governance adapter for Google Gemini API.

File: New: src/agent_os/integrations/gemini_adapter.py

Hints:

  • Inherit from BaseIntegration
  • Intercept function_call blocks
  • Support safety settings governance
  • Add tests in test_integrations.py

Read the thread · 2026-02-09 · closed · 1 comment

[Code] Add type hints to base integration

Improve type hints in the base integration module.

File: src/agent_os/integrations/base.py

Hints:

  • Type all method parameters
  • Use Protocol for callback types
  • Add TypeVar for generic integration
  • Run mypy to verify correctness

Read the thread · 2026-02-09 · closed · 1 comment

Most recent

[Feature] Add policy violation webhook notifications

Send webhook notifications when policy violations are detected.

File: src/agent_os/base_agent.py

Hints:

  • Add webhook_url to AgentConfig
  • POST violation details to webhook on detection
  • Make async to avoid blocking
  • Include agent_id, violation_type, timestamp

Read the thread · 2026-02-09 · closed · 1 comment

[Test] Add tests for LangChain batch governance

Test that batch operations are governed correctly.

File: tests/test_integrations.py

Hints:

  • Create governed LangChain runnable
  • Run batch of 5 inputs
  • Verify each was policy-checked
  • Test with some inputs violating policy

Read the thread · 2026-02-09 · closed · 0 comments

[Docs] Document MCP server tools and schemas

Document all 15 MCP tools with their schemas and usage.

File: New file or README section

Hints:

  • List all tools: CMVKVerify, KernelExecute, IATPSign, etc.
  • Document input/output schemas
  • Include curl/Claude Desktop usage examples

Read the thread · 2026-02-09 · closed · 0 comments

[Docs] Add docstrings to OpenAI adapter

Add comprehensive docstrings to all methods in the OpenAI integration.

File: src/agent_os/integrations/openai_adapter.py

Hints:

  • Document the wrapping strategy
  • Explain SIGKILL support
  • Include usage examples

Read the thread · 2026-02-09 · closed · 0 comments

[Docs] Document the GovernancePolicy dataclass

Add detailed docstrings to GovernancePolicy and all its fields.

File: src/agent_os/integrations/base.py

Hints:

  • Document each field with type, default, and purpose
  • Explain how policies compose
  • Add example policy configurations

Read the thread · 2026-02-09 · closed · 0 comments

[Feature] Add agentos serve CLI command for HTTP API

Implement an HTTP API server command for the CLI.

File: src/agent_os/cli.py:14

Hints:

  • Add serve subcommand to argparse
  • Use uvicorn or http.server for a simple server
  • Expose /health and /status endpoints
  • Accept --port and --host arguments

Read the thread · 2026-02-09 · closed · 1 comment

Add example: Governed chatbot with memory

Description Create a simple example showing a chatbot that uses Agent OS governance with conversation memory.

Requirements

  • Use the EMK (Episodic Memory Kernel) module
  • Show how policies can restrict what the chatbot remembers
  • Include a README explaining the example

Good for:

  • Learning the codebase
  • Python developers new to Agent OS

Files to modify:

  • examples/chat-agent/ (create or modify)

Read the thread · 2026-02-03 · closed · 1 comment

MCP Server: Publish to GitHub MCP Registry and verify cross-platform support

Overview

With GitHub Copilot Extensions (GitHub Apps) deprecated in favor of MCP, we should focus on distributing the existing MCP server implementation.

Background: https://github.blog/changelog/2025-09-24-deprecate-github-copilot-extensions-github-apps/

Current State

The MCP server at \xtensions/mcp-server/\ is fully functional with:

  • 10 MCP tools
  • Policy engine
  • Compliance checking
  • npm package: @agentos/mcp-server\

Tasks

Phase 1: Verification

  • Verify npm packa

Read the thread · 2026-02-02 · closed · 0 comments

Docs: Clarify Shadow Mode multi-step fidelity limitations

Shadow Mode diverges from reality after first simulated step for multi-step agents. Need replay engine with recorded real outputs, or clearly document single-step-only fidelity guarantee.

Read the thread · 2026-01-31 · closed · 0 comments

The remaining reports are on the project's issue tracker.