CLAUDE.md@.claude/packages/about-system-info git:20260926.9c73d12A

Immutable. This exact content never changes and is served at /api/v1/blob/6b733f7569adb991.

# CLAUDE.md — `about-system` (`packages/about-system-info`)

**npm name:** `about-system` · **skill:** [`skills/about-system`](../../../skills/about-system/SKILL.md)
· **runner:** Vitest · **build:** Vite

Cross-platform CLI + library that prints CPU, memory, disk, uptime, public IP,
ISP and installed tools as one compact emoji line. Designed to be dropped into
`config.fish` / `.zshrc`, so it runs on **every terminal launch**.

## What that implies

- **Startup cost is the product.** Anything you add to the default path is paid
  on every shell open. Network lookups (public IP, ISP) go through the cache in
  `src/cache/`; keep them off the synchronous path.
- **Three OSes, really.** Windows, macOS and Linux each take a different branch
  in `src/info/`. A change that only reads right on Linux is a regression.
- There is a **desktop app** under `native/`, built by
  `.github/workflows/about-system-desktop.yml`, with the CLI compiled inside it
  so nothing needs installing first.

- **`about-system web`** serves a React + shadcn/ui dashboard (`web/`, its own
  Vite config) plus `GET /api/info` from `src/web-server.ts`. The web build runs
  *after* the library build because the library build empties `dist/`. React,
  Tailwind and the shadcn deps are devDependencies — they are bundled into
  `dist/web`, so the published CLI gains no runtime deps.

## Layout

`src/about-system-cli.ts` (bin) · `src/index.ts` (library) ·
`src/info/` (per-block collectors) · `src/cache/` · `src/bench/` ·
`src/system-info-api.ts` · `src/web-server.ts` · `src/types/` ·
`web/` (dashboard: `src/App.tsx`, shadcn components in `src/components/ui`)

```bash
cd packages/about-system-info
bun run test
bun run build          # Vite — consumers get dist/, not src/
```