This repository contains the native TypeScript compiler and language server. The source directories of interest that we have are: Most compiler development takes place in tsc/internal, and most behaviors can be tested via compiler tests. Most development on the codebase is in Go. Standard Go commands and practices apply, but we primarily use a tool called hereby to build, run tests, and other tasks. Run npx hereby --tasks to see all available commands. Always make sure code is formatted, linted,…
How to write, run, and debug compiler tests and fourslash (LSP) tests in the TypeScript repository. Covers test file formats, directives, markers, baseline management, and the fourslash verification API.
Are you doing security research on this repo? This document covers what guarantees and non-guarantees are provided. Consult this document before reporting a security issue or conducting security research.
These rules apply to all public contributions and interactions, no matter how they're done. The entity operating or authorizing the contributions and interactions is responsible for them. AI assistance does not relieve contributors of responsibility for their work. "The AI did it" is not an excuse. Violations may result in contributions being closed without further comment. Cases of deception, evasion, or repeat violations may result in account bans. Allowed: - All AI usage that remains non-public (e.g. questions, reviews, local…
Plain text files in a repository that tell a coding agent how the project works: commands to run, conventions to follow and things to avoid. CLAUDE.md, AGENTS.md, cursor rules and skills are the common kinds.
CLAUDE.md or AGENTS.md?
CLAUDE.md is read by Claude Code. AGENTS.md is an open format that Codex, Cursor and other agents read. Many projects keep one and point the other at it.
What is a skill?
A folder with a SKILL.md that describes one capability, such as filling PDFs or reviewing code. The agent loads it only when the task calls for it.
Can I search my own team's files too?
Your agents already can, over MCP, limited to the files you're allowed to read. Searching them from this page is coming.