Skip to main content
Use this reference to choose a package and check the changes that affect an upgrade.

​
Packages

The CLI package metadata still lists Node.js 18, but current dependencies need a newer runtime. See CLI installation. For release history and upgrade details, see Release Notes. Related packages: @upstash/context7-tools-ai-sdk (Vercel AI SDK tools) and @upstash/context7-pi (pi.dev extension). For how queries are stored and used (reranking providers, retention, and enterprise opt-out), see Data Privacy.

​
Versioning & Migration

Breaking changes and deprecations to be aware of when upgrading.

​
SDK — v0.2.0 API simplification

The SDK API was simplified in 0.2.0:
  • getDocs() was replaced by getContext(query, libraryId, options), which takes a query for relevance-based retrieval
  • searchLibrary(query, libraryName) now takes both a query and a library name
  • Response types were renamed (Library and Documentation instead of SearchResult, CodeDocsResponse, etc.)
  • Pagination, mode, topic, and limit options were removed from context retrieval

​
CLI — research mode removed (v0.4.1)

Research mode was removed entirely. The query-docs MCP tool no longer accepts or forwards a researchMode parameter, and the CLI no longer exposes a --research flag on ctx7 docs.

​
CLI — skill commands deprecated

The ctx7 skills ... commands are deprecated and will stop working in the next major release. The context7-mcp and find-docs skills installed by ctx7 setup are unaffected.