tscircuit-cli
Command line tool for developing, managing and publishing tscircuit electronics code with a local dev server.
What it does and how it connects
tscircuit-cli is the command line tool for developing, managing and publishing tscircuit code, described by the README as the npm for tscircuit. It installs globally from npm, and tsci dev starts a local development server for a package in the current directory.
Commands cover initializing a project, cloning a package from the registry, pushing code to the registry, logging in and out, exporting tscircuit code to formats including Altium, building and evaluating circuit JSON, transpiling TypeScript and TSX, adding and removing component packages, running the tsci agent, generating schematic and PCB snapshots with an optional 3D preview, searching for footprints, CAD models or packages, importing components from JLCPCB or the registry, converting .kicad_mod files to TSX, simulating, and running diagnostic checks.
Export is a named strength: tsci export can write a TSX circuit or an existing Circuit JSON file as an Altium project, producing native .PcbDoc and .SchDoc files and a .PrjPcb project, and tsci build with the KiCad PCM flag selects a KiCad Plugin and Content Manager license schema for distribution.
Alternatives
Compare side by side- tscircuit
The tscircuit platform for designing electronics in React, rather than the CLI that develops and publishes its packages.
- kicad-to-circuit-json
Converts KiCad projects to Circuit JSON, rather than a CLI for developing tscircuit code.
- synth
Compiles text circuit designs into KiCad boards, rather than a CLI for the tscircuit registry workflow.
Recurring errors it addresses
Error Index entries this tool is built to reduce or work around.
- `tsci check netlist` printed 'R1 (1kOhm undefined)' and listed resistor pins as anode and cathode, so the netlist people read to check a design was wrong about what is on the board.Error Index
- An LLM-generated tscircuit design wrote holeDiameter on a hole element, a natural guess since platedhole and via use that prop name. The zod schema silently stripped the unknown key instead of rejecting it, leaving a null-diameter hole that turned into NaN bounds in the autorouter. Compilation reported 0 errors while the entire autoroute pass died for every net on the board; the crash only showed in stderr.Error Index
- A tscircuit user filed three autorouter bugs, including clearance violations 19 mm away from the footprints he changed.Error Index
Sources
Not verified
- Pricing: none stated on the repo.
- Real user voices: no real linked post read for this page; the repo has no public issues listed via the API.
- No GitHub releases exist, so latest release fields are null.
- A named individual builder: the repository names the tscircuit organization, not a person.
Last verified November 6, 2026. Listings are informational. The evidence score measures public, verifiable evidence and is not an endorsement or a compatibility claim.