Cable Intel
bringing transparency to cables without u having to buy new ones. just for fun and to test some search patterns
Cable Intel
Cable Intel helps you identify cables quickly, label them consistently, and avoid trial-and-error.
What It Does
- Identifies cables from catalog data or free-text printed markings.
- Infers connector/power/data/video capabilities and summarizes expected behavior.
- Suggests deterministic physical label colors for strap and holder classes.
- Supports catalog filtering (brand, connector type, length, color, price bucket).
- Includes a TUI for ingest discovery, seeding, and quality checks.
How It Works
apps/web: SvelteKit workspace UI (catalog + manual flows).packages/backend: Convex schema/actions/queries and ingest pipeline.packages/shopify-cable-source: Shopify source discovery/extraction.apps/tui: terminal ingest manager.- Preview deployments run
preview-validation(seed + runtime QA + browser smoke with artifacts/replay links).
Quick Start
bun install
bun run dev:setup
bun run dev
Web app: http://localhost:5173
Testing And CI
| Layer | Present | Tooling | Runs in CI |
|---|---|---|---|
| unit | yes | bun test (core suites) |
yes |
| integration | yes | bun test integration suites |
no |
| e2e api | yes | bun test packages/backend/convex/ingest.e2e.test.ts |
no |
| e2e web | yes | agent-browser smoke scripts |
yes |
Primary CI workflows:
.github/workflows/ci.yml(quality + build).github/workflows/preview-seed.yml(preview seed + browser QA).github/workflows/org-required-checks.yml(required merge gate)
Deployment And External Services
- Deploy target: Vercel (
vercel.json) - Data/backend: Convex
- LLM path: AI Gateway/OpenAI-compatible via
aiSDK - Optional analytics:
PUBLIC_VERCEL_ANALYTICS_DSN(already wired inapps/web/src/routes/+layout.ts)
Preview automation secrets:
CONVEX_DEPLOY_KEY_PREVIEWBROWSERBASE_API_KEYBROWSERBASE_PROJECT_IDVERCEL_AUTOMATION_BYPASS_SECRET
API Surface
There is no public REST API in this repo. App/backend integration is via Convex actions and queries.
Active Backlog
- Search quality phase 2: semantic rerank + measured eval (#92)
License
MIT License. See LICENSE.
Copyright 2026 SHPIT LLC.
