Repository navigation
[Awareness] Consolidating Strands SDK Repositories into a Monorepo #2286
Description
Activity
- pinned this issue
on May 12, 2026 - added a commit that references this issue
on May 26, 2026 Post-Merge Cleanup Tracker
Audit of what needs updating once the monorepo becomes the source of truth. Organized by priority.
P0 — Fix before this becomes source of truth
Area Files Issue Package metadata strands-py/pyproject.toml,strands-ts/package.json,strands-py-wasm/pyproject.tomlRepository URLs still point to old separate repos Root AGENTS.md ./AGENTS.mdTitle says "TypeScript SDK", directory tree shows nonexistent sdk-typescript/, ignores Python/docs/WASMIssue templates .github/ISSUE_TEMPLATE/config.ymlPoints docs link to strands-agents/docs(archived)PR template .github/PULL_REQUEST_TEMPLATE.mdReferences "PR in the agent-docs repo" designs/README.md Line 26 "Fork the docs repository" — designs are now in-tree site/AGENTS.md Lines 1, 3, 215 References private-docs-staging, links TS SDK as externalstrands-py/AGENTS.md Line 22 Directory tree shows strands-agents/as standalone rootRoot CONTRIBUTING.md Overall Python-only — no TS/docs contribution workflow mentioned site/CONTRIBUTING.md Line 76 Links to sdk-python/issuesas if externalContribution docs site/src/content/docs/contribute/(3 files)Clone instructions for separate repos strands-wasm/README.md Line 27 Clone URL: strands-agents/sdk-typescript.git.agents/ skills strands-review/SKILL.md,code-verification.mdURLs to strands-agents/docsand stale API pathsRoot README.md Overall Presents as Python-only SDK; no mention of TS, docs, or WASM Duplicate dev docs dev-docs/PR.mdvsstrands-py/docs/PR.mdNear-identical files P0.5 — Fix before first publish (build correctness)
Area Files Issue Site build scripts site/scripts/clone-sdks.tsClones sdk-typescript and sdk-python from GitHub instead of using the local monorepo copies P2 — Should fix eventually (published docs site, ~100+ pages)
Scripted URL replacement pass once the repo is renamed to
strands-sdk:- ~40+ example pages linking to
strands-agents/docs/blob/main/docs/examples/ - ~35+ pages linking to separate
sdk-pythonorsdk-typescriptsource - Site utilities (
github.ts,structured-data.ts,redirect.ts) with hardcoded repo names - Navigation config and components (
HeroSection.astro,CommunityContributionAside.astro)
P3 — Leave as-is (historical, URLs still resolve)
- Blog posts (historical content)
- Design documents (PR/issue links)
- Source code comments referencing issue numbers
Also tracked separately: #2351 (Python wheel missing README and LICENSE in published package)
- ~40+ example pages linking to
Issues migrated from https://github.com/strands-agents/sdk-typescript, as are the tags (with a
typescriptprefix)Issues migrated from https://github.com/strands-agents/docs, as are the tags. Now with a
docsprefix- marked [Awareness] Consolidating Strands SDK Repositories into a Monorepo #2603 as a duplicate of this issue
on Jun 5, 2026 - marked [Awareness] Consolidating Strands SDK Repositories into a Monorepo #2450 as a duplicate of this issue
on Jun 5, 2026 PRs that addressed monorepo reference cleanup but didn't reference this issue:
harness-sdk:
- #2701 — fix: update remaining sdk-python references to harness-sdk
- #2698 — fix(site): update stale GitHub links from old repos to harness-sdk
- #2695 — fix(site): update community contribution link to harness-sdk repo
- #2677 — refactor(site): use local monorepo source instead of cloning SDKs
- #2675 — fix(strands-ts): update package.json repository URLs to harness-sdk
- #2641 — chore(site): update GitHub dropdown to harness-sdk and add evals
- #2618 — chore: update repository references to harness-sdk
- #2616 — docs: remove archived agent-builder references
sdk-typescript:
docs:
- unpinned this issue
on Jun 19, 2026 - added 2 commits that reference this issue
on Jul 16, 2026
Summary
We're planning to consolidate the core Strands Agents repositories into a single monorepo. The
strands-agents/sdk-pythonrepo will be renamed tostrands-agents/strands-sdkand serve as the home for all consolidated code. Other repos (sdk-typescript,docs,mcp-server) will have their histories merged in and then be archived.This issue is an early announcement to give the community visibility into the change, explain the reasoning, and share the tentative timeline.
What's changing: The source code for the Python SDK, TypeScript SDK, documentation site, and MCP server will live in one repository (
strands-agents/strands-sdk, formerlysdk-python) instead of separate ones.What's NOT changing: Package names (
strands-agentson PyPI,@strands/sdkon npm), install commands, versioning, and release cadence all stay the same. This is a source repository consolidation only.Why
Our team works across both Python and TypeScript, and features frequently touch both SDKs plus documentation. The current multi-repo setup creates friction:
A monorepo lets features, docs, and tests ship together in a single PR with unified CI/CD.
What's Moving
sdk-pythonstrands-py/strands-sdk)sdk-typescriptstrands-ts/,strands-wasm/, etc.docssite/,designs/mcp-serverstrands-mcp/devtoolsHow
We're using
sdk-pythonas the final home and renaming it tostrands-sdk. Each repository's full git history is merged in meaning that all commits preserved. Open issues from merged repos will be transferred. Archived repos will have redirects pointing to the new location.Tentative Timeline
sdk-python. Validate CI/CD, publishing pipelines, and builds. Original repos still accept contributions during this period.sdk-python→strands-sdk. Final sync, cutover, issue transfer, archive source repos.What This Means for Contributors
strands-agents/strands-sdk.strands-py/,strands-ts/,site/, etc.) and path-based CI so only relevant checks run on your PR.For the full design document with detailed rationale and industry research, see the design proposal.