upgrade-claude-adapter

Sync this fork of @anthropic-ai/claude-agent-acp (packages/agent/src/adapters/claude) with a newer upstream release: bump the claude-agent-sdk / @agentclientprotocol/sdk, port upstream bug fixes and new SDK message handling, preserve the fork's divergences, verify, and update UPSTREAM.md. Use when asked to "upgrade/sync the claude adapter", "bump the agent SDK", or "port upstream claude-agent-acp changes".

Ir para a instalação

Repositório: PostHog/code
Última atividade na origem: 31 de julho de 2026 às 16:41
Idioma detectado do SKILL.md: inglês
Estrelas: 179
Forks: 65

Opções de instalação

Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.

npx skills add https://github.com/PostHog/code --skill upgrade-claude-adapter

O comando permanece em uma só linha. Role horizontalmente para revisá-lo antes de copiar.

Prefere uma cópia local? Baixe os arquivos disponíveis atualmente no SkillsMP.

Revise os arquivos de origem

Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.

Explorador de arquivos

54 arquivos

SKILL.md

Instruções da origem · Visualização somente leitura

Voltar à pesquisa Voltar à instalação

merging-prs

Merge a PR into main through the Trunk merge queue and babysit it until it lands. Enqueue with a "/trunk merge" comment, then poll the "Trunk Merge Queue" check run and the PR state until it is MERGED or FAILED, reporting the Trunk bot's failure reason if the PR is kicked out. Use when asked to merge a PR, "merge when ready", "land it", "ship it", or to babysit/watch a PR through the queue. Never use `gh pr merge` in this repo -- the queue is the only path into main.

2026-07-30

storybook-stories

Write Storybook stories for PostHog UI components. Covers the provider stack stories run inside, the key gotcha that tRPC/useHostTRPC queries never resolve in Storybook (so data-fetching components render empty), and the pure-presentational split that makes a component storyable. Use when adding or fixing a *.stories.tsx file under packages/ui.

2026-07-22

test-electron-app

Drive the real running PostHog Electron app (live tRPC, workspace-server, real data) over CDP with agent-browser. Connect to the running app on port 9222, snapshot the accessibility tree to verify changes, click/type/navigate, and screenshot the actual desktop app only when explicitly asked. Use when asked to test, verify, dogfood, screenshot or interact with the running app. For regression specs use the Playwright E2E suite.

2026-07-22

Ver todas deste repositório

Upgrade the Claude ACP adapter (upstream sync)

This is a runbook for syncing our fork of @anthropic-ai/claude-agent-acp (the upstream Zed/agentclientprotocol ACP agent) that lives in packages/agent/src/adapters/claude/ with a newer upstream release. The fork is heavily diverged. The job is to port the valuable upstream changes (SDK bumps, bug fixes, new SDK-message handling) while preserving every intentional divergence — not to make the fork identical to upstream.

UPSTREAM.md (this directory) is the source of truth for the fork point, last-synced version/commit, the file mapping, the PostHog-only code, and the intentional divergences. Read it first, update it last.

This file is a runbook, not an auto-registered slash command. Invoke it by telling Claude to "follow the upgrade skill in the claude adapter dir." Move it to .claude/skills/<name>/SKILL.md if you ever want it runnable as /<name>.

Inputs you need before starting

Upstream source checkout — a local git clone of github.com/agentclientprotocol/claude-agent-acp. You need its history to diff. If the user hasn't given the path, ask for it (it's usually somewhere like ~/Cloud/claude-agent-acp). Do not guess.

This repo — the fork under .

name

upgrade-claude-adapter

description

Upgrade the Claude ACP adapter (upstream sync)

This file is a runbook, not an auto-registered slash command. Invoke it by telling Claude to "follow the upgrade skill in the claude adapter dir." Move it to .claude/skills/<name>/SKILL.md if you ever want it runnable as /<name>.

Inputs you need before starting

Upstream source checkout — a local git clone of github.com/agentclientprotocol/claude-agent-acp. You need its history to diff. If the user hasn't given the path, ask for it (it's usually somewhere like ~/Cloud/claude-agent-acp). Do not guess.
This repo — the fork under .

Upstream	Fork
`acp-agent.ts` prompt loop, lifecycle, cancel	`claude-agent.ts`
inline message/stream/result/system conversion	`conversion/sdk-to-acp.ts`
inline prompt→SDK conversion	`conversion/acp-to-sdk.ts`
`tools.ts` (tool_use→ACP, PostToolUse hook)	`conversion/tool-use-to-acp.ts`, `hooks.ts`
model alias resolution	`session/models.ts`, `session/model-config.ts`
options / system prompt	`session/options.ts`
permissions	`permissions/*`

upgrade-claude-adapter

Opções de instalação

Revise os arquivos de origem

Upgrade the Claude ACP adapter (upstream sync)

Inputs you need before starting

Upgrade the Claude ACP adapter (upstream sync)

Inputs you need before starting

Process

0. Orient (read, don't write)

1. Triage every commit

2. Map upstream → fork

3. Bump dependencies

4. Find the breaking-change surface

5. Port in phases — bug fixes first, then features

6. Verify (all of it)

7. Update `UPSTREAM.md` (do this last)

Fork facts worth remembering

upgrade-claude-adapter

Informações da origem

Opções de instalação

Revise os arquivos de origem

Mais deste repositório

Mais deste repositório

Upgrade the Claude ACP adapter (upstream sync)

Inputs you need before starting

Upgrade the Claude ACP adapter (upstream sync)

Inputs you need before starting

Process

0. Orient (read, don't write)

1. Triage every commit

2. Map upstream → fork

3. Bump dependencies

4. Find the breaking-change surface

5. Port in phases — bug fixes first, then features

6. Verify (all of it)

7. Update UPSTREAM.md (do this last)

Fork facts worth remembering

7. Update `UPSTREAM.md` (do this last)