GitHub Copilot SDK - Supercharged

21 languages. One SDK. Agents for every app.

Embed Copilot's agentic workflows in your application. A production-tested agent runtime you can invoke programmatically in any major language. You define agent behavior, Copilot handles planning, tool invocation, file edits, and more.

Available SDKs

SDK	Location	Installation	Build System
Node.js / TypeScript	nodejs/	npm install copilot-sdk-supercharged	npm
Python	python/	pip install copilot-sdk-supercharged	pip
Go	go/	go get github.com/github/copilot-sdk/go	Go modules
.NET / C#	dotnet/	dotnet add package CopilotSDK.Supercharged	NuGet
Java	java/	Maven / Gradle	Maven
Rust	rust/	cargo add copilot-sdk-supercharged	Cargo
Ruby	ruby/	gem install copilot-sdk-supercharged	RubyGems
PHP	php/	Composer	Composer
Swift	swift/	Swift Package Manager	SPM
Kotlin	kotlin/	Gradle	Gradle
C++	cpp/	CMake	CMake
C	c/	CMake	CMake
Dart	dart/	pub	pub
Scala	scala/	sbt	sbt
R	r/	CRAN	CRAN
Perl	perl/	CPAN	CPAN
Lua	lua/	luarocks install copilot-sdk-supercharged	LuaRocks
Shell / Bash	shell/	Source	N/A
Elixir	elixir/	{:copilot_sdk_supercharged, "~> 1.0"}	Hex
Haskell	haskell/	Cabal	Cabal
Clojure	clojure/	net.clojars.jeremiahisaacson/copilot-sdk-supercharged	Clojars

See the individual SDK READMEs for usage examples and API reference. For architecture details, see MULTI_LANGUAGE_SDKS.md.

Getting Started

For a complete walkthrough, see the Getting Started Guide.

Quick steps:

1. Install the Copilot CLI:

   Follow the Copilot CLI installation guide to install the CLI, or ensure copilot is available in your PATH.

2. Install your preferred SDK using the commands above.

3. See the SDK README for usage examples and API documentation.

Architecture

All SDKs communicate with the Copilot CLI server via JSON-RPC:

Your Application
       ↓
  SDK Client
       ↓ JSON-RPC
  Copilot CLI (server mode)

The SDK manages the CLI process lifecycle automatically. You can also connect to an external CLI server. See the Getting Started Guide for details on running the CLI in server mode.

FAQ

Do I need a GitHub Copilot subscription to use the SDK?

Yes, a GitHub Copilot subscription is required to use the GitHub Copilot SDK, unless you are using BYOK (Bring Your Own Key). With BYOK, you can use the SDK without GitHub authentication by configuring your own API keys from supported LLM providers. For standard usage (non-BYOK), refer to the GitHub Copilot pricing page, which includes a free tier with limited usage.

How does billing work for SDK usage?

Billing for the GitHub Copilot SDK is based on the same model as the Copilot CLI, with each prompt being counted towards your premium request quota. For more information on premium requests, see Requests in GitHub Copilot.

Does it support BYOK (Bring Your Own Key)?

Yes, the GitHub Copilot SDK supports BYOK (Bring Your Own Key). You can configure the SDK to use your own API keys from supported LLM providers (e.g. OpenAI, Azure AI Foundry, Anthropic) to access models through those providers. See the BYOK documentation for setup instructions and examples.

Note: BYOK uses key-based authentication only. Microsoft Entra ID (Azure AD), managed identities, and third-party identity providers are not supported.

What authentication methods are supported?

The SDK supports multiple authentication methods:

• GitHub signed-in user - Uses stored OAuth credentials from copilot CLI login
• OAuth GitHub App - Pass user tokens from your GitHub OAuth app
• Environment variables - COPILOT_GITHUB_TOKEN, GH_TOKEN, GITHUB_TOKEN
• BYOK - Use your own API keys (no GitHub auth required)

See the Authentication documentation for details on each method.

Do I need to install the Copilot CLI separately?

Yes, the Copilot CLI must be installed separately. The SDKs communicate with the Copilot CLI in server mode to provide agent capabilities.

What tools are enabled by default?

By default, the SDK will operate the Copilot CLI in the equivalent of --allow-all being passed to the CLI, enabling all first-party tools, which means that the agents can perform a wide range of actions, including file system operations, Git operations, and web requests. You can customize tool availability by configuring the SDK client options to enable and disable specific tools. Refer to the individual SDK documentation for details on tool configuration and Copilot CLI for the list of tools available.

Can I use custom agents, skills or tools?

Yes, the GitHub Copilot SDK allows you to define custom agents, skills, and tools. You can extend the functionality of the agents by implementing your own logic and integrating additional tools as needed. Refer to the SDK documentation of your preferred language for more details.

Are there instructions for Copilot to speed up development with the SDK?

Yes, check out the custom instructions at github/awesome-copilot.

What models are supported?

All models available via Copilot CLI are supported in the SDK. The SDK also exposes a method which will return the models available so they can be accessed at runtime.

Is the SDK production-ready?

The GitHub Copilot SDK is currently in Technical Preview. While it is functional and can be used for development and testing, it may not yet be suitable for production use.

How do I report issues or request features?

Please use the GitHub Issues page to report bugs or request new features. We welcome your feedback to help improve the SDK.

Quick Links

• Getting Started - Tutorial to get up and running
• Authentication - GitHub OAuth, BYOK, and more
• Architecture - How all 21 SDKs work under the hood
• Contributing - How to contribute (new languages welcome!)
• Website - Landing page with examples in every language

Contributing

See CONTRIBUTING.md for contribution guidelines.

License

MIT