Skip to content

docs: add litellm.harness agent harness docs - #1945

Merged
ishaan-berri merged 40 commits into
mainfrom
litellm_harness_docs
Sep 30, 2026
Merged

ishaan-berri merged 40 commits into
mainfrom
litellm_harness_docs

Conversation

@ishaan-berri

@ishaan-berri ishaan-berri commented Sep 30, 2026 •

Copy link
Copy Markdown
Contributor

Adds docs for litellm.harness, which runs Claude Code, Codex, OpenCode and Deep Agents from Python with one API. The SDK PR is still in progress in BerriAI/litellm (branch litellm_harness_sdk), so the section is marked Beta and the API may still shift.

The gateway is the main path. The overview example uses Gateway(api_base=..., api_key=...) (or LITELLM_PROXY_API_BASE / LITELLM_PROXY_API_KEY), and the second page, "Using with AI Gateway", walks through a config.yaml with one coder model group, creating a virtual key, running all four harnesses against it, and finding spend per harness through the harness,<name> request tags in the UI, /tag/daily/activity and /spend/logs. SDK-only mode is covered after that as the alternative.

Capabilities match what v1 actually ships: runtimes have to already be in the sandbox, default permissions are full, Claude Code and OpenCode support read-only/edit/full, Codex supports read-only/full with no tool filtering, and only Deep Agents has custom tools and history.

What changed:

  • docs/harness/*.md adds 17 pages
  • sidebars.js adds a new "Agent Harnesses" category after "LiteLLM AI Gateway (Proxy)" with non-collapsible Getting started / Harnesses / Guides / Reference groups, plus a link from the Integrations "Agent SDKs" list. No other entries change.
  • src/css/custom.css adds an IBM Plex / JetBrains Mono font import and a commented litellm.harness docs block at the end. It only applies to .harness-sidebar and to html[class*='docs-doc-id-harness/'], so nothing else on the site is affected. Dark mode works.

I built it in a local preview with the site's theme and the build passes. I checked the overview, the gateway page and the Codex page in light mode, and the supported-harnesses page in dark mode. The build output includes the uppercase group labels, the thin left rule with an accent bar on the active item, and the tables with light borders.

@vercel

vercel Bot commented Sep 30, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
litellm Ready Ready Preview Sep 30, 2026 6:58pm UTC

Request Review

@ishaan-berri
ishaan-berri merged commit 23a2ea3 into main Sep 30, 2026
3 of 4 checks passed
@ishaan-berri
ishaan-berri deleted the litellm_harness_docs branch September 30, 2026 19:56

This branch was successfully deployed

1 active deployment
Preview — c8082d01 Deployed Sep 30, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant