{
  "markdown": "# LightShip\n\n**Faster production-agent iteration, without a developer bottleneck.**\n\n[![CI](https://github.com/lightshipHQ/lightship/actions/workflows/ci.yml/badge.svg)](https://github.com/lightshipHQ/lightship/actions/workflows/ci.yml)\n[![Release](https://img.shields.io/github/v/release/lightshipHQ/lightship?include_prereleases&sort=semver)](https://github.com/lightshipHQ/lightship/releases)\n[![Container](https://img.shields.io/badge/container-ghcr.io%2FlightshipHQ%2Flightship-blue)](https://github.com/lightshipHQ/lightship/pkgs/container/lightship)\n[![License](https://img.shields.io/github/license/lightshipHQ/lightship)](LICENSE)\n[![GitHub stars](https://img.shields.io/github/stars/lightshipHQ/lightship)](https://github.com/lightshipHQ/lightship/stargazers)\n\nLightShip gives domain experts governed, self-serve access to production agent traces. It sits in\nfront of your existing OpenTelemetry data in ClickHouse, so humans and AI coding agents can\ninvestigate real conversations and tool calls without database credentials or another observability\nsilo.\n\n[Documentation](https://lightship.mintlify.site) ·\n[Website](https://lightship.sh/) ·\n[Try the hosted demo](https://lightship-production.up.railway.app/) ·\n[Contribute](CONTRIBUTING.md)\n\n## Why LightShip\n\n- **Find the patterns behind failures.** Ask business questions across conversations, tool calls,\n  and outcomes using Codex, Claude, or another MCP client.\n- **Keep your existing trace store.** Bind LightShip to your OpenTelemetry table without copying\n  traces into a separate platform.\n- **Instrument once; define policies later.** Select existing columns and attribute keys as\n  authorization inputs, then create or change policies without re-instrumenting. The same policy\n  governs the web UI, REST API, and MCP.\n- **Keep large investigations out of model context.** The local MCP companion writes authorized\n  exports into the agent workspace and returns only paths and counts to the conversation.\n\n## Try the hosted demo\n\nOpen the [hosted demo](https://lightship-production.up.railway.app/). Its sign-in page provides the\ncredentials for a disposable administrator account. The dataset contains 132 recorded synthetic\nsupport-agent conversations across two fictional retailers.\n\nIn the web UI you can:\n\n- inspect traces, conversations, and tool results;\n- preview the tenant-scoped access available to each account team;\n- review searchable and policy-accessible fields; and\n- create a short-lived API key to investigate the same data through MCP.\n\nFollow the [tenant-scoped access guide](https://lightship.mintlify.site/guides/tenant-scoped-trace-access)\nto explore the access-control setup and verify its boundary. To investigate the traces\nconversationally, follow the [MCP connection guide](https://lightship.mintlify.site/use/mcp), then\nuse the tested prompt sequence in the tenant-scoped access guide.\n\nThe deployment is an intentionally editable sandbox. Do not enter real or sensitive data.\n\n## How it works\n\n1. An administrator binds LightShip to an existing OpenTelemetry span table in ClickHouse.\n2. They choose which columns and map keys may be used for search and access rules.\n3. LightShip compiles each caller’s roles and attributes into the ClickHouse query before returning\n   any trace through the web UI, REST, or MCP.\n\nA trace is the authorization unit: **one matching span grants access to the complete trace**.\nLightShip never gives restricted users direct ClickHouse credentials.\n\n## Performance\n\nQuery performance depends on the layout and indexes of your existing ClickHouse trace table. After\nyou select the fields available to filters and access policies, LightShip reviews the table's\nsorting key and skip indexes and suggests DDL for missing indexes. These recommendations are\nadvisory: LightShip never changes your ClickHouse schema automatically. See how to\n[review the optimization report](https://lightship.mintlify.site/guides/tenant-scoped-trace-access#5-review-the-clickhouse-optimization-report).\n\n## Get started\n\nThe documentation contains the maintained setup and reference material:\n\n- [Install the latest alpha](https://github.com/lightshipHQ/lightship/releases)\n- [Browse the Go package](https://pkg.go.dev/github.com/lightshipHQ/lightship)\n- [Connect your ClickHouse](https://lightship.mintlify.site/quickstart)\n- [Define roles and policies](https://lightship.mintlify.site/configure/roles-and-policies)\n- [Connect Codex, Claude, and other MCP clients](https://lightship.mintlify.site/use/mcp)\n- [Use the web UI](https://lightship.mintlify.site/use/web-ui)\n- [Deploy and configure LightShip](https://lightship.mintlify.site/operate/deployment)\n- [Browse the API reference](https://lightship.mintlify.site/api-reference/introduction)\n\nNeed help deploying LightShip in your environment? [Talk to us](https://cal.com/lightship/30min).\n\n## Security and project status\n\nLightShip protects only requests sent through LightShip. Direct ClickHouse access bypasses its\npolicies. It does not currently detect PII, redact payloads, or hide individual spans. Query\nauditing is best-effort, so an audit-write failure is logged without failing the trace request.\n\nLightShip is an experimental alpha with no stable release. Evaluate it using synthetic or\nnon-sensitive data in an isolated environment. Read the [security guidance](SECURITY.md) and\n[current limitations](https://lightship.mintlify.site/operate/limitations) before deployment.\n\n## Feedback\n\nWe want to help make autonomous work trustworthy and governable. If your team operates AI agents\nin production, we would love to hear what LightShip should support next.\n\n[Talk to us](https://cal.com/lightship/30min) or\n[open a GitHub issue](https://github.com/lightshipHQ/lightship/issues/new/choose).\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development and testing,\n[SECURITY.md](SECURITY.md) for vulnerability reporting, and [CHANGELOG.md](CHANGELOG.md) for changes.\nLightShip is licensed under [Apache-2.0](LICENSE).\n",
  "bytes": 6007,
  "sha": "d33fa35ddbad22b224cb2335a4a15f505e6679f824b631d0a60f19a60b8edbc9",
  "repo_slug": "lightshiphq/lightship",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_lightshiphq_lightship_5e8d41aa/readme"
}