tsci-agent 0.1.0

package/dist/skill/elements/smtpad.md

@@ -0,0 +1,35 @@
+# `<smtpad />`
+
+The `<smtpad />` element is used to represent a surface mount pad.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="10mm" height="10mm">
+    <chip name="U1" footprint={
+      <footprint>
+        <smtpad
+          pcbX="0mm"
+          pcbY="0mm"
+          layer="top"
+          shape="rect"
+          width="5mm"
+          height="5mm"
+          portHints={["pin1"]}
+        />
+      </footprint>
+    } />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `name`, `shape`, `width`, `height`, `rectBorderRadius`, `cornerRadius`, `portHints`, `coveredWithSolderMask`
+
+## References
+
+- Props: [RectSmtPadProps](https://github.com/tscircuit/props#rectsmtpadprops-smtpad)
+- Source: [lib/components/smtpad.ts](https://github.com/tscircuit/props/blob/main/lib/components/smtpad.ts)
+- Local docs: [docs/docs/footprints/smtpad.mdx](../docs/docs/footprints/smtpad.mdx)

package/dist/skill/elements/solderjumper.md

@@ -0,0 +1,21 @@
+# `<solderjumper />`
+
+Small pads that can be cut or bridged with solder for configuration options.
+
+## Example
+
+```tsx
+export default () => (
+  <solderjumper name="SJ1" footprint="solderjumper2_bridged12" bridgedPins={[["1","2"]]} />
+)
+```
+
+## Props
+
+Commonly used: `bridgedPins`, `bridged`, `name`, `footprint`, `connections`
+
+## References
+
+- Props: [SolderJumperProps](https://github.com/tscircuit/props#solderjumperprops-solderjumper)
+- Source: [lib/components/solderjumper.ts](https://github.com/tscircuit/props/blob/main/lib/components/solderjumper.ts)
+- Local docs: [docs/docs/elements/solderjumper.mdx](../docs/docs/elements/solderjumper.mdx)

package/dist/skill/elements/subcircuit.md

@@ -0,0 +1,29 @@
+# `<subcircuit />`
+
+A `<subcircuit />` is a powerful organizational element in tscircuit that represents a collection of elements that are tightly coupled. Subcircuits are often used for a small functional block, such as a voltage regulator.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="10mm" height="10mm">
+    <subcircuit name="subcircuit1" schX={-2}>
+      <resistor name="R1" resistance="1k" footprint="0402" />
+    </subcircuit>
+    <subcircuit name="subcircuit2" schX={2}>
+      <resistor name="R2" resistance="1k" footprint="0402"  />
+    </subcircuit>
+    <trace from=".subcircuit1 .R1 .pin1" to=".subcircuit2 .R2 .pin1" />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `name`, `footprint`, `connections`
+
+## References
+
+- Props: [SubcircuitProps](https://github.com/tscircuit/props#subcircuitprops-subcircuit)
+- Source: [lib/components/subcircuit.ts](https://github.com/tscircuit/props/blob/main/lib/components/subcircuit.ts)
+- Local docs: [docs/docs/elements/subcircuit.mdx](../docs/docs/elements/subcircuit.mdx)

package/dist/skill/elements/subpanel.md

@@ -0,0 +1,26 @@
+# `<subpanel />`
+
+Nested grouping inside a manufacturing `<panel />`.
+
+## Example
+
+```tsx
+export default () => (
+  <panel width="100mm" height="80mm">
+    <subpanel layoutMode="grid" boardGap="2mm">
+      <board width="20mm" height="10mm" />
+      <board width="20mm" height="10mm" />
+    </subpanel>
+  </panel>
+)
+```
+
+## Props
+
+Commonly used: `width`, `height`, `children`
+
+## References
+
+- Props: [SubpanelProps](https://github.com/tscircuit/props#subpanelprops-subpanel)
+- Source: [lib/components/subpanel.ts](https://github.com/tscircuit/props/blob/main/lib/components/subpanel.ts)
+- Local docs: [docs/docs/guides/tscircuit-essentials/panelization.mdx](../docs/docs/guides/tscircuit-essentials/panelization.mdx)

package/dist/skill/elements/switch.md

@@ -0,0 +1,21 @@
+# `<switch />`
+
+A switch is a mechanical device that can be used to connect or disconnect a circuit.
+
+## Example
+
+```tsx
+export default () => (
+  <switch name="SW1" type="spst" />
+)
+```
+
+## Props
+
+Commonly used: `type`, `isNormallyClosed`, `spdt`, `spst`, `dpst`, `dpdt`, `simSwitchFrequency`, `simCloseAt`
+
+## References
+
+- Props: [SwitchProps](https://github.com/tscircuit/props#switchprops-switch)
+- Source: [lib/components/switch.ts](https://github.com/tscircuit/props/blob/main/lib/components/switch.ts)
+- Local docs: [docs/docs/elements/switch.mdx](../docs/docs/elements/switch.mdx)

package/dist/skill/elements/symbol.md

@@ -0,0 +1,54 @@
+# `<symbol />`
+
+Used to define custom schematic representations for chips using primitive drawing components like rectangles, circles, lines, and arcs.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="10mm" height="10mm">
+    <chip
+      name="Q1"
+      symbol={
+        <symbol>
+          {/* Outer circle */}
+          <schematiccircle center={{ x: 0.1, y: 0 }} radius={0.55} isFilled={false} strokeWidth={0.05} />
+          {/* Base vertical bar */}
+          <schematicline x1={-0.1} y1={-0.5} x2={-0.1} y2={0.5} strokeWidth={0.05} />
+          {/* Base input line */}
+          <schematicline x1={-0.7} y1={0} x2={-0.1} y2={0} strokeWidth={0.05} />
+          {/* Collector line (diagonal then vertical) */}
+          <schematicline x1={-0.1} y1={0.2} x2={0.35} y2={0.5} strokeWidth={0.05} />
+          <schematicline x1={0.35} y1={0.5} x2={0.35} y2={1} strokeWidth={0.05} />
+          {/* Emitter line (diagonal then vertical) */}
+          <schematicline x1={-0.1} y1={-0.2} x2={0.35} y2={-0.5} strokeWidth={0.05} />
+          <schematicline x1={0.35} y1={-0.5} x2={0.35} y2={-1} strokeWidth={0.05} />
+          {/* Emitter arrow (V shape pointing outward along emitter line) */}
+          <schematicpath
+            strokeWidth={0.05}
+            points={[
+              { x: 0.16, y: -0.25},
+              { x: 0.2, y: -0.40 },
+              { x: 0.06, y: -0.44 },
+            ]}
+          />
+          {/* Ports */}
+          <port name="B" direction="left" schX={-0.7} schY={0} />
+          <port name="C" direction="up" schX={0.35} schY={1} />
+          <port name="E" direction="down" schX={0.35} schY={-1} />
+        </symbol>
+      }
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `originalFacingDirection`, `width`, `height`, `name`, `footprint`, `connections`
+
+## References
+
+- Props: [SymbolProps](https://github.com/tscircuit/props#symbolprops-symbol)
+- Source: [lib/components/symbol.ts](https://github.com/tscircuit/props/blob/main/lib/components/symbol.ts)
+- Local docs: [docs/docs/elements/symbol.mdx](../docs/docs/elements/symbol.mdx)

package/dist/skill/elements/testpoint.md

@@ -0,0 +1,26 @@
+# `<testpoint />`
+
+A `<testpoint />` is a designated location on a PCB that provides easy access for testing, debugging, and measuring electrical signals. Test points are essential for troubleshooting circuits and verifying proper operation during development and manufacturing.
+
+## Example
+
+```tsx
+export default () => (
+    <testpoint
+      name="TP1"
+      footprintVariant="pad"
+      padShape="circle"
+      padDiameter="1mm"
+    />
+)
+```
+
+## Props
+
+Commonly used: `footprintVariant`, `padShape`, `padDiameter`, `holeDiameter`, `width`, `height`, `connections`, `name`
+
+## References
+
+- Props: [TestpointProps](https://github.com/tscircuit/props#testpointprops-testpoint)
+- Source: [lib/components/testpoint.ts](https://github.com/tscircuit/props/blob/main/lib/components/testpoint.ts)
+- Local docs: [docs/docs/elements/testpoint.mdx](../docs/docs/elements/testpoint.mdx)

package/dist/skill/elements/trace.md

@@ -0,0 +1,28 @@
+# `<trace />`
+
+The `<trace />` element represents an electrical connection between two or more points in your circuit. Traces can connect components, nets, or specific pins on components.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="10mm" height="10mm">
+    <resistor name="R1" resistance="1k" footprint="0402" pcbX={-2} schX={-2} />
+    <capacitor name="C1" capacitance="100nF" footprint="0402" pcbX={2} />
+    <trace
+      from=".R1 > .pin1"
+      to=".C1 > .pin1"
+    />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `via`, `fromLayer`, `toLayer`, `code`, `message`, `path`, `key`, `thickness`
+
+## References
+
+- Props: [TraceProps](https://github.com/tscircuit/props#traceprops-trace)
+- Source: [lib/components/trace.ts](https://github.com/tscircuit/props/blob/main/lib/components/trace.ts)
+- Local docs: [docs/docs/elements/trace.mdx](../docs/docs/elements/trace.mdx)

package/dist/skill/elements/tracehint.md

@@ -0,0 +1,24 @@
+# `<tracehint />`
+
+Autorouter hint that nudges a trace through preferred points.
+
+## Example
+
+```tsx
+export default () => (
+  <board width="20mm" height="12mm">
+    <trace from=".U1 > .pin1" to=".R1 > .pin1">
+      <tracehint offset={{ x: 0, y: 3 }} />
+    </trace>
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `x`, `y`, `via`, `toLayer`, `for`, `order`, `offset`, `offsets`
+
+## References
+
+- Props: [TraceHintProps](https://github.com/tscircuit/props#tracehintprops-tracehint)
+- Source: [lib/components/trace-hint.ts](https://github.com/tscircuit/props/blob/main/lib/components/trace-hint.ts)

package/dist/skill/elements/transistor.md

@@ -0,0 +1,25 @@
+# `<transistor />`
+
+A transistor is a three-terminal semiconductor device that can amplify or switch electronic signals. It is a fundamental component in many electronic circuits, including amplifiers, oscillators, and digital logic gates.
+
+## Example
+
+```tsx
+export default () => (
+  <transistor
+    name="Q1"
+    type="npn"
+    footprint="sot23"
+  />
+)
+```
+
+## Props
+
+Commonly used: `type`, `connections`, `name`, `footprint`
+
+## References
+
+- Props: [TransistorProps](https://github.com/tscircuit/props#transistorprops-transistor)
+- Source: [lib/components/transistor.ts](https://github.com/tscircuit/props/blob/main/lib/components/transistor.ts)
+- Local docs: [docs/docs/elements/transistor.mdx](../docs/docs/elements/transistor.mdx)

package/dist/skill/elements/via.md

@@ -0,0 +1,30 @@
+# `<via />`
+
+A via is a plated hole that connects different layers of a PCB. Vias are commonly used to route traces between layers and for thermal management.
+
+## Example
+
+```tsx
+export default () => (
+    <board width={5} height={5}>
+      <via
+        fromLayer="top"
+        toLayer="bottom"
+        outerDiameter="0.8mm"
+        holeDiameter="0.4mm"
+        pcbX={0}
+        pcbY={0}
+      />
+    </board>
+  )
+```
+
+## Props
+
+Commonly used: `name`, `fromLayer`, `toLayer`, `holeDiameter`, `outerDiameter`, `connectsTo`, `netIsAssignable`, `footprint`
+
+## References
+
+- Props: [ViaProps](https://github.com/tscircuit/props#viaprops-via)
+- Source: [lib/components/via.ts](https://github.com/tscircuit/props/blob/main/lib/components/via.ts)
+- Local docs: [docs/docs/elements/via.mdx](../docs/docs/elements/via.mdx)

package/dist/skill/elements/voltageprobe.md

@@ -0,0 +1,36 @@
+# `<voltageprobe />`
+
+Measure voltages at specific nodes during SPICE simulation.
+
+## Example
+
+```tsx
+export default () => (
+  <board routingDisabled>
+    <voltagesource name="V1" voltage="5V" />
+    <resistor name="R1" resistance="1k" />
+    <resistor name="R2" resistance="1k" />
+
+    <trace from=".V1 > .pin1" to="net.VCC" />
+    <trace from="net.VCC" to=".R1 > .pin1" />
+    <trace from=".R1 > .pin2" to=".R2 > .pin1" />
+    <trace from=".R2 > .pin2" to="net.GND" />
+    <trace from="net.GND" to=".V1 > .pin2" />
+
+    <voltageprobe name="VP_R1" connectsTo=".R1 > .pin1" />
+    <voltageprobe name="VP_R2" connectsTo=".R2 > .pin1" />
+
+    <analogsimulation duration="10ms" timePerStep="0.1ms" spiceEngine="ngspice" />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `name`, `connectsTo`, `referenceTo`, `color`, `footprint`, `connections`
+
+## References
+
+- Props: [VoltageProbeProps](https://github.com/tscircuit/props#voltageprobeprops-voltageprobe)
+- Source: [lib/components/voltageprobe.ts](https://github.com/tscircuit/props/blob/main/lib/components/voltageprobe.ts)
+- Local docs: [docs/docs/elements/voltageprobe.mdx](../docs/docs/elements/voltageprobe.mdx)

package/dist/skill/elements/voltagesource.md

@@ -0,0 +1,36 @@
+# `<voltagesource />`
+
+Add a voltage source for SPICE simulations and schematic power inputs.
+
+## Example
+
+```tsx
+export default () => (
+  <board routingDisabled>
+    <voltagesource
+      name="V1"
+      waveShape="square"
+      voltage="5V"
+      frequency="1kHz"
+      dutyCycle={0.5}
+    />
+    <resistor name="R1" resistance="1k" />
+
+    <trace from=".V1 > .pin1" to=".R1 > .pin1" />
+    <trace from=".V1 > .pin2" to=".R1 > .pin2" />
+
+    <voltageprobe name="VP_OUT" connectsTo=".R1 > .pin1" />
+    <analogsimulation duration="5ms" timePerStep="0.05ms" spiceEngine="ngspice" />
+  </board>
+)
+```
+
+## Props
+
+Commonly used: `voltage`, `frequency`, `peakToPeakVoltage`, `waveShape`, `phase`, `dutyCycle`, `connections`, `name`
+
+## References
+
+- Props: [VoltageSourceProps](https://github.com/tscircuit/props#voltagesourceprops-voltagesource)
+- Source: [lib/components/voltagesource.ts](https://github.com/tscircuit/props/blob/main/lib/components/voltagesource.ts)
+- Local docs: [docs/docs/elements/voltagesource.mdx](../docs/docs/elements/voltagesource.mdx)

package/dist/skill/scripts/export_svgs.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if ! command -v tsci >/dev/null 2>&1; then
+  echo "tsci not found. Install it first:" >&2
+  echo "  npm install -g tscircuit" >&2
+  echo "  # or" >&2
+  echo "  bun install --global tscircuit" >&2
+  exit 127
+fi
+
+FILE="${1:-index.circuit.tsx}"
+BASE="${FILE%.*}"
+
+OUT_SCHEM="${BASE}-schematic.svg"
+OUT_PCB="${BASE}-pcb.svg"
+
+tsci export "$FILE" -f schematic-svg -o "$OUT_SCHEM"
+tsci export "$FILE" -f pcb-svg -o "$OUT_PCB"
+
+echo "Wrote:" >&2
+echo "  $OUT_SCHEM" >&2
+echo "  $OUT_PCB" >&2

package/dist/skill/scripts/fetch_ai_txt.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+OUT="${1:-ai.txt}"
+
+if command -v curl >/dev/null 2>&1; then
+  curl -L "https://docs.tscircuit.com/ai.txt" -o "$OUT"
+elif command -v wget >/dev/null 2>&1; then
+  wget -O "$OUT" "https://docs.tscircuit.com/ai.txt"
+else
+  echo "Neither curl nor wget found. Install one of them to download ai.txt" >&2
+  exit 127
+fi
+
+echo "Wrote $OUT" >&2

package/dist/skill/scripts/smoke_test.sh

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if ! command -v tsci >/dev/null 2>&1; then
+  echo "tsci not found. Install it first:" >&2
+  echo "  npm install -g tscircuit" >&2
+  echo "  # or" >&2
+  echo "  bun install --global tscircuit" >&2
+  exit 127
+fi
+
+TARGET="${1:-.}"
+
+# Determine starting directory
+if [[ -f "$TARGET" ]]; then
+  TARGET_DIR="$(dirname "$TARGET")"
+else
+  TARGET_DIR="$TARGET"
+fi
+
+# Walk up to find a tscircuit project (has tscircuit.config.json or tscircuit in package.json)
+PROJECT_ROOT="$TARGET_DIR"
+FOUND_PROJECT=false
+while [[ "$PROJECT_ROOT" != "/" ]]; do
+  if [[ -f "$PROJECT_ROOT/tscircuit.config.json" ]]; then
+    FOUND_PROJECT=true
+    break
+  fi
+  if [[ -f "$PROJECT_ROOT/package.json" ]]; then
+    if grep -q '"tscircuit"' "$PROJECT_ROOT/package.json" 2>/dev/null; then
+      FOUND_PROJECT=true
+      break
+    fi
+  fi
+  PROJECT_ROOT="$(dirname "$PROJECT_ROOT")"
+done
+
+if [[ "$FOUND_PROJECT" != "true" ]]; then
+  echo "Error: Not inside a tscircuit project." >&2
+  echo "No tscircuit.config.json or tscircuit dependency found." >&2
+  echo "Create a project with: tsci init" >&2
+  exit 1
+fi
+
+echo "Running: tsci build ${TARGET}" >&2
+tsci build "$TARGET"
+
+echo "OK: tsci build" >&2

package/dist/skill/templates/arduino-shield-led.tsx

@@ -0,0 +1,14 @@
+// Requires: npm install @tscircuit/common
+import React from "react"
+import { ArduinoShield } from "@tscircuit/common"
+
+export default () => (
+  <ArduinoShield name="example">
+    <resistor name="R1" resistance="220ohm" footprint="0805" pcbX={0} pcbY={5} />
+    <led name="LED1" color="red" footprint="0603" pcbX={0} pcbY={-5} />
+
+    <trace from=".D13" to=".R1 > .pin1" />
+    <trace from=".R1 > .pin2" to=".LED1 > .pin1" />
+    <trace from=".LED1 > .pin2" to=".GND2" />
+  </ArduinoShield>
+)

package/dist/skill/templates/chip-with-pinouts.tsx

@@ -0,0 +1,65 @@
+import type { ChipProps } from "tscircuit"
+
+const pinLabels = {
+  pin1: "GND",
+  pin2: "TRIG",
+  pin3: "OUT",
+  pin4: "RESET",
+  pin5: "CTRL",
+  pin6: "THRES",
+  pin7: "DISCH",
+  pin8: "VCC",
+} as const
+
+export const NE555 = (props: ChipProps<typeof pinLabels>) => (
+  <chip
+    {...props}
+    pinLabels={pinLabels}
+    pinAttributes={{
+      VCC: { requiresPower: true },
+      RESET: { mustBeConnected: true },
+    }}
+    schPinArrangement={{
+      leftSide: {
+        direction: "top-to-bottom",
+        pins: ["RESET", "CTRL", "THRES", "TRIG"],
+      },
+      rightSide: {
+        direction: "top-to-bottom",
+        pins: ["VCC", "OUT", "DISCH", "GND"],
+      },
+    }}
+    supplierPartNumbers={{ jlcpcb: ["C46749"] }}
+    footprint="dip8"
+  />
+)
+
+export default () => (
+  <board width="40mm" height="30mm">
+    <NE555 name="U1" />
+    <resistor name="R1" resistance="1k" footprint="0402" />
+    <resistor name="R2" resistance="10k" footprint="0402" />
+    <capacitor name="C1" capacitance="10uF" footprint="0805" />
+    <capacitor name="C2" capacitance="10nF" footprint="0402" />
+    <capacitor name="C3" capacitance="100nF" footprint="0402" />
+
+    <trace from="U1.VCC" to="net.VCC" />
+    <trace from="U1.GND" to="net.GND" />
+    <trace from="U1.RESET" to="net.VCC" />
+    <trace from="C3.pin1" to="net.VCC" />
+    <trace from="C3.pin2" to="net.GND" />
+
+    <trace from="U1.CTRL" to="C2.pin1" />
+    <trace from="C2.pin2" to="net.GND" />
+
+    <trace from="R1.pin1" to="net.VCC" />
+    <trace from="R1.pin2" to="U1.DISCH" />
+    <trace from="U1.DISCH" to="R2.pin1" />
+    <trace from="R2.pin2" to="net.TIMING" />
+
+    <trace from="U1.THRES" to="net.TIMING" />
+    <trace from="U1.TRIG" to="net.TIMING" />
+    <trace from="C1.pin1" to="net.TIMING" />
+    <trace from="C1.pin2" to="net.GND" />
+  </board>
+)

package/dist/skill/templates/group-layout.tsx

@@ -0,0 +1,13 @@
+// Demonstrates <group /> for positioning multiple components together.
+// This example focuses on layout—add <trace /> elements for connectivity.
+import React from "react"
+
+export default () => (
+  <board width="20mm" height="20mm">
+    <group pcbX={5} pcbY={5}>
+      <resistor name="R1" resistance="1k" footprint="0402" pcbX={2.5} pcbY={2.5} />
+      <resistor name="R2" resistance="1k" footprint="0402" pcbX={2.5} pcbY={0} />
+      <resistor name="R3" resistance="1k" footprint="0402" pcbX={2.5} pcbY={-2.5} />
+    </group>
+  </board>
+)

package/dist/skill/templates/minimal-board.tsx

@@ -0,0 +1,13 @@
+// Minimal board with two components and trace connectivity.
+import React from "react"
+
+export default () => (
+  <board width="10mm" height="10mm">
+    <resistor name="R1" resistance="1k" footprint="0402" pcbX={-2} schX={-2} />
+    <capacitor name="C1" capacitance="100nF" footprint="0402" pcbX={2} schX={2} />
+
+    <trace from=".R1 > .pin1" to=".C1 > .pin1" />
+    <trace from=".R1 > .pin2" to="net.GND" />
+    <trace from=".C1 > .pin2" to="net.GND" />
+  </board>
+)

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "tsci-agent",
+  "version": "0.1.0",
+  "description": "An interactive coding agent and command line utility for coding tscircuit TSX circuits",
+  "type": "module",
+  "bin": {
+    "tsci-agent": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "dev": "bun run src/cli.ts",
+    "bundle": "bun build src/cli.ts --target bun --outfile dist/cli.js && bun run scripts/copy-skill.ts && bun run scripts/make-executable.ts",
+    "build": "bun run bundle",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "smoke": "./dist/cli.js --smoke-test-assets",
+    "start": "bun run dist/cli.js",
+    "prepack": "bun run build"
+  },
+  "dependencies": {
+    "@earendil-works/pi-coding-agent": "^0.80.2"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "skill": "github:tscircuit/skill",
+    "typescript": "latest"
+  },
+  "keywords": [
+    "pi",
+    "tscircuit",
+    "coding-agent",
+    "bun"
+  ],
+  "license": "MIT",
+  "packageManager": "bun@1.3.14"
+}