# Code Storage > Off the shelf Git infrastructure for your AI application. This is the full-text companion to https://code.storage/llms.txt. That file is a curated index of links; this one expands the same surface into prose, so an agent can answer questions about Code Storage without fetching every page. ## What Code Storage is Code Storage is a managed Git infrastructure layer for automated systems. AI applications, agents, CI jobs, and backend services create and use Git repositories through SDK and HTTP interfaces. Each repository stores standard Git objects and refs. Standard Git clients can clone, fetch, and push through Git over HTTPS. A minimal SDK example: const store = new GitStorage({ name: 'test', key }); const repo = await store.createRepo({ id: 'repo' }); const remote = await repo.getRemoteURL(); // test.code.storage/repo ## Getting started The documentation lives at https://code.storage/docs. - [Introduction](https://code.storage/docs/getting-started/introduction): Learn what Code Storage is — Git infrastructure for agents — the repository and ref model, and a map of the features and workflows. - [Agent Setup](https://code.storage/docs/getting-started/agent-setup): Set up an agent with the current Code Storage docs. - [Authentication & Security](https://code.storage/docs/getting-started/authentication): Create an API key, store it, and sign JWTs. Set token scopes, expiration, and ref policies for each client. - [Quick Start](https://code.storage/docs/getting-started/quickstart): Install the SDK, initialize the client, create a repository, and make your first commit. ## Guides ### Features - [Git Operations](https://code.storage/docs/guides/git-operations): Use standard Git commands over HTTPS — clone, push, pull, and fetch with JWT-authenticated remotes. - [Git LFS](https://code.storage/docs/guides/git-lfs): Track large files over the same JWT-authenticated remote. No separate LFS server, no extra configuration. - [Git Notes](https://code.storage/docs/guides/git-notes): Attach metadata to commits and keep commit history unchanged. Keep each note stream isolated by ref. - [Ref Policies](https://code.storage/docs/guides/ref-policies): Use JWT ref policies for branch protection. Limit the refs that a token can update and the update types it permits. - [Commit Signing](https://code.storage/docs/guides/commit-signing): Register OpenPGP or SSH public keys. Require signed commits on selected refs. - [Import Namespace](https://code.storage/docs/guides/imports): Push a whole repository in through the +import URL, with immediate cold archival. - [Ephemeral Namespace](https://code.storage/docs/guides/ephemeral-branches): Create isolated refs for previews, CI artifacts, and experiments. Promote an ephemeral branch to the default namespace. - [Repository Forks](https://code.storage/docs/guides/forking): Create lightweight copies of existing repositories for experiments, templates, and isolated development. - [GitHub Sync](https://code.storage/docs/guides/github-sync): Mirror a GitHub repository through Code Storage with GitHub App sync, public mode, and Git LFS. - [Generic Sync](https://code.storage/docs/guides/generic-sync): Mirror a GitLab, Bitbucket, Gitea, Forgejo, Codeberg, or SourceHut repository over HTTPS. - [Webhooks](https://code.storage/docs/guides/webhooks): Receive real-time HTTP POST notifications for push and repo sync events, verified with HMAC signatures. ### Workflows - [Connect a Sandbox](https://code.storage/docs/guides/sandboxes): Clone repositories into third-party sandbox providers like Modal, E2B, and Daytona with authenticated Git URLs. - [Store Session State](https://code.storage/docs/guides/session-state): Store session state as ephemeral commits. Exchange commit pointers and keep normal branches unchanged. - [Resume Sandbox Work](https://code.storage/docs/guides/resume-sandbox-work): Restore the last session state in a new sandbox. Reject writes from the old sandbox. - [Run Parallel Attempts](https://code.storage/docs/guides/parallel-attempts): Start several attempts from one commit. Compare their diffs and promote the best result. - [Show Live Diffs](https://code.storage/docs/guides/live-diffs): Render an agent branch as a live diff. Refresh the view when a new state arrives. ## SDK reference [Code Storage SDK](https://code.storage/docs/reference/sdk/index) — generate authenticated URLs, create commits without git, stream file contents, and manage repositories from your application code. The reference is grouped by resource: - Repositories: create a repo, find one, list repos, delete a repo, get a remote URL, get an import remote URL, pull upstream, and create, update, or delete Git credentials. - Branches: list, create, and delete branches; preview a merge; merge; get a branch diff; promote an ephemeral branch. - Commits: list commits, get a commit, create a commit, create a commit from a diff, get a commit diff, restore a commit. - Files: list files, list files with metadata, stream a file, head a file, stream an archive, grep, and blame. - Tags: list, create, and delete tags. - Notes: get, create, append to, and delete notes. ## HTTP API [Code Storage HTTP API](https://code.storage/docs/reference/api/overview) — it mirrors the SDK's primitives over plain HTTPS, so any runtime can mint JWT-backed remotes, paginate branches and commits, stream diffs, or create commits without a local git client. Base URL: https://api.{org}.code.storage/api Authentication: Bearer YOUR_JWT_TOKEN List endpoints use cursor-based pagination. - [Code Storage OpenAPI spec](https://code.storage/openapi.json): OpenAPI 3.1 description of the HTTP API, served without authentication for SDK generators and agents. - [Code Storage API catalog](https://code.storage/.well-known/api-catalog): RFC 9727 catalog linking the HTTP API to its OpenAPI description and its reference documentation. - [Code Storage MCP server](https://code.storage/.well-known/mcp.json): Discovery card for the documentation MCP server — a Streamable HTTP endpoint at https://code.storage/docs/mcp whose tools search these docs. ## Pages - [Home](https://code.storage/): Product overview — off-the-shelf, white-label Git infrastructure built for scale. - [Pricing](https://code.storage/pricing): Plans and pricing for Code Storage. - [Changelog](https://code.storage/changelog): Product updates and release notes. - [Status](https://status.code.storage): Service status. - [Docs index (llms.txt)](https://code.storage/docs/llms.txt): LLM-friendly index of the documentation, regenerated when the docs change. - [API index (llms.txt)](https://code.storage/api/llms.txt): Section-scoped index for the HTTP API, the OpenAPI spec, authentication, webhooks and the MCP server. ## Legal - [Terms of Service](https://code.storage/legal/terms): Terms governing use of Code Storage. - [Privacy Policy](https://code.storage/legal/privacy): How we handle personal data. - [Service Level Agreement](https://code.storage/legal/sla): Uptime and support commitments. - [Data Processing Addendum](https://code.storage/legal/dpa): Data processing terms for customers. - [Sub-processors](https://code.storage/legal/sub-processors): Third-party sub-processors we use. ## Company - [Pierre Computer Company](https://pierre.computer): The company behind Code Storage. ## See also - [@pierre/trees](https://trees.software/llms.txt): Open source file tree rendering library for the web. - [@pierre/diffs](https://diffs.com/llms.txt): Open source diff and code rendering library for the web. - [diffshub](https://diffshub.com): View code changes from any public GitHub diff—PRs, comparisons, commits, diffs, and patches—with a super-freaking-fast, beautiful, and virtualized interface by replacing github.com with diffshub.com.