diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index b3b9721..92f11d9 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -11,6 +11,7 @@ concurrency: ${{ github.workflow }}-${{ github.ref }} permissions: contents: write pull-requests: write + id-token: write jobs: # Build native binaries for all platforms first @@ -219,7 +220,6 @@ jobs: commit: 'chore: version packages' env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} - NODE_AUTH_TOKEN: ${{ secrets.NPM_VERCEL_TOKEN_ELEVATED }} # Create GitHub release with binaries after npm publish github-release: diff --git a/README.md b/README.md index fbbb122..4a7fa51 100644 --- a/README.md +++ b/README.md @@ -51,7 +51,7 @@ agent-browser install # Download Chromium ### From Source ```bash -git clone https://github.com/vercel-labs/agent-browser +git clone https://github.com/leeguooooo/agent-browser cd agent-browser pnpm install pnpm build @@ -60,6 +60,42 @@ pnpm link --global # Makes agent-browser available globally agent-browser install ``` +### Fork Maintenance (Independent Release + Upstream Sync) + +If you maintain a fork and publish your own CLI, use this workflow: + +1. Keep an upstream-tracking branch (`upstream-main`) for clean sync history. +2. Keep your release branch (`main`) for production-ready code only. +3. Merge upstream into short-lived sync branches, then open PRs into `main`. + +One-time setup: + +```bash +git remote add upstream https://github.com/vercel-labs/agent-browser.git +git fetch upstream +``` + +Regular sync: + +```bash +pnpm run sync:upstream:push +``` + +This command: +- Fetches `upstream/main` +- Fast-forwards local `upstream-main` +- Creates `sync/YYYY-MM-DD` from local `main` +- Merges `upstream-main` into the sync branch +- Pushes the sync branch to `origin` (with `sync:upstream:push`) + +If merge conflicts occur, resolve them on the sync branch and open a PR as usual. + +Independent release checklist for forks: +- Use your own npm package name and CLI binary name (avoid conflicts with upstream package ownership). +- Update `repository`, `bugs`, and `homepage` in `package.json` to your fork. +- Configure npm Trusted Publishing (OIDC) for your package and repository workflow. +- Keep release tags and changelog in your own namespace/versioning policy. + ### Linux Dependencies On Linux, install system dependencies: @@ -971,7 +1007,7 @@ The `--help` output is comprehensive and most agents can figure it out from ther Add the skill to your AI coding assistant for richer context: ```bash -npx skills add vercel-labs/agent-browser +npx skills add leeguooooo/agent-browser ``` This works with Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Goose, OpenCode, and Windsurf. The skill is fetched from the repository, so it stays up to date automatically -- do not copy `SKILL.md` from `node_modules` as it will become stale. @@ -981,7 +1017,7 @@ This works with Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Goose, O Install as a Claude Code skill: ```bash -npx skills add vercel-labs/agent-browser +npx skills add leeguooooo/agent-browser ``` This adds the skill to `.claude/skills/agent-browser/SKILL.md` in your project. The skill teaches Claude Code the full agent-browser workflow, including the snapshot-ref interaction pattern, session management, and timeout handling. diff --git a/docs/src/app/api/docs-chat/route.ts b/docs/src/app/api/docs-chat/route.ts index ab43afc..2a12072 100644 --- a/docs/src/app/api/docs-chat/route.ts +++ b/docs/src/app/api/docs-chat/route.ts @@ -14,7 +14,7 @@ const DEFAULT_MODEL = "anthropic/claude-haiku-4.5"; const SYSTEM_PROMPT = `You are a helpful documentation assistant for agent-browser, a headless browser automation CLI designed for AI agents. -GitHub repository: https://github.com/vercel-labs/agent-browser +GitHub repository: https://github.com/leeguooooo/agent-browser Documentation: https://agent-browser.dev npm package: agent-browser diff --git a/docs/src/app/installation/page.mdx b/docs/src/app/installation/page.mdx index f203965..c109015 100644 --- a/docs/src/app/installation/page.mdx +++ b/docs/src/app/installation/page.mdx @@ -51,7 +51,7 @@ agent-browser install # Download Chromium ## From source ```bash -git clone https://github.com/vercel-labs/agent-browser +git clone https://github.com/leeguooooo/agent-browser cd agent-browser pnpm install pnpm build @@ -110,7 +110,7 @@ agent-browser works with any AI agent out of the box. For richer context: Install the skill for your AI coding assistant: ```bash -npx skills add vercel-labs/agent-browser +npx skills add leeguooooo/agent-browser ``` This works with Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Goose, OpenCode, and Windsurf. The skill is fetched from the repository and stays up to date automatically. diff --git a/docs/src/components/header.tsx b/docs/src/components/header.tsx index 39e4a00..ef4ee3d 100644 --- a/docs/src/components/header.tsx +++ b/docs/src/components/header.tsx @@ -53,7 +53,7 @@ export function Header() {