# Service Carbonyl (`services/carbonyl/`)

Navigateur **terminal** basé sur Chromium — amont **[fathyb/carbonyl](https://github.com/fathyb/carbonyl)**, intégré au monorepo via le sous-module **`services/carbonyl/upstream/`**.

## Rôle

- **Pilotage / visualisation** d’URLs dans un terminal (SSH sans GUI, session locale).
- **Prévisualisation** des applications déployées en **test** : URL optionnelle dans **`projects/<id>/conf.json`** → **`smart_ide.preview_urls.test`**, ouverte par **`scripts/open-carbonyl-preview-test.sh`**.
- **API pour l’IDE** : **`services/smart-ide-tools-bridge/`** — `POST /v1/carbonyl/open-plan` (retourne la commande à lancer en terminal) — [API/smart-ide-tools-bridge-api.md](../API/smart-ide-tools-bridge-api.md).

Carbonyl lui-même reste un **processus interactif** (Docker ou binaire `carbonyl`), pas un listener HTTP dédié.

## Exploitation

Voir **[`services/carbonyl/README.md`](../../services/carbonyl/README.md)** et **[features/carbonyl-terminal-browser.md](../features/carbonyl-terminal-browser.md)**.

## Voir aussi

- [anythingllm-devtools](service-anythingllm-devtools.md) — orchestration AnythingLLM (HTTP), distincte de la navigation terminal.
- [browser-automation-criteria.md](../features/browser-automation-criteria.md) — critères pour un futur `browser-automation-api` (automatisation headless).