Thomas CLI

CLI pessoal para a Thomas Workstation — atalhos e orquestração do fluxo diário de desenvolvimento.

Versão 1.2.0 — fundação + start / system / diagnose.

Design completo: docs/DESIGN.md

---

Instalação

npm install
npm run build
npm link

Dev sem build:

npm run dev -- system

---

Comandos

Workspace

thomas search
thomas search teron
thomas open portfolio
thomas start portfolio          # infra + install + editor + dev + browser
thomas start portfolio --no-dev # só prepara e abre editor

Flags de start:

Flag	Efeito
--no-editor	não abre o editor
--no-browser	não abre o browser
--no-install	não roda install
--no-dev	não sobe o script dev
--no-infra	não sobe serviços do manifesto

Infraestrutura

thomas infra up
thomas infra up postgres redis
thomas infra down
thomas infra restart
thomas infra logs
thomas infra status
thomas infra status --all

Aliases legados (com aviso):

thomas up | down | restart | logs

Sistema

thomas system      # CPU, RAM, disco, Docker, top processos
thomas diagnose    # problemas + sugestões

Legados:

thomas doctor      # → prefira diagnose
thomas mem         # → prefira system
thomas ps          # docker ps no host
thomas clean

Gerador

thomas new react meu-projeto

Globals

thomas --yes
thomas --dry-run
thomas --verbose

---

Config

Na primeira execução:

• ~/.config/thomas/config.yml
• ~/.config/thomas/aliases.yml

Manifesto opcional por projeto (.thomas.yml):

name: portfolio
dev: npm run dev
url: http://localhost:5173
infra:
  - postgres
  - redis
browser: true

Exemplo: examples/thomas.yml.

Env:

Variável	Efeito
THOMAS_WORKSPACE_ROOT	root do workspace
THOMAS_INFRA_DIR	dir do compose de infra
THOMAS_EDITOR	editor
THOMAS_CONFIG	path do config.yml
THOMAS_YES=1	--yes
THOMAS_DRY_RUN=1	--dry-run

---

Roadmap

PR	Escopo	Status
0	Fundação, open/search, infra	✅
1	start, system, diagnose	✅
2	clean granular
3	new interativo
4	ship / sync
5	morning
6	setup
7	backup
8	polish

---

Licença

MIT