4NK
14c974f54c
- New service: tools bridge (port 37147) registry + Carbonyl/PageIndex/Chandra POST jobs - config/services.local.env.example and gitignore for services.local.env - .env.example for repos-devtools, regex-search, ia-dev-gateway, orchestrator, claw proxy, langextract - Orchestrator intents: tools.registry, tools.carbonyl.plan, tools.pageindex.run, tools.chandra.ocr - Docs: API + repo service fiche, architecture index; do not commit dist/
48 lines
2.5 KiB
Markdown
48 lines
2.5 KiB
Markdown
# carbonyl — navigateur terminal (amont)
|
||
|
||
[Carbonyl](https://github.com/fathyb/carbonyl) est un navigateur basé sur Chromium affiché dans le terminal (Web APIs, médias, utilisable sans serveur graphique, y compris via SSH).
|
||
|
||
Ce répertoire **`services/carbonyl/`** regroupe :
|
||
|
||
- **`upstream/`** : sous-module Git pointant vers le dépôt amont **fathyb/carbonyl** (fork / suivi des évolutions amont dans ce monorepo).
|
||
- **`run-carbonyl.sh`** : lancement via **Docker** (image publique `fathyb/carbonyl`) ou binaire **`carbonyl`** si installé (`npm install -g carbonyl`).
|
||
|
||
Ne pas exécuter **`git submodule update --init --recursive`** dans **`upstream/`** tant qu’un build Chromium complet n’est pas requis : le sous-module **chromium** amont est très volumineux. Pour un usage quotidien, préférer Docker ou le binaire précompilé.
|
||
|
||
## Prérequis
|
||
|
||
- **Docker** (recommandé) : `docker run --rm -ti fathyb/carbonyl https://example.com`
|
||
- ou dépendances **Chromium** sur l’hôte si build / binaire local — voir le [readme amont](https://github.com/fathyb/carbonyl/blob/main/readme.md).
|
||
|
||
## Variables (optionnelles)
|
||
|
||
| Variable | Rôle |
|
||
|----------|------|
|
||
| `CARBONYL_DOCKER_IMAGE` | Image Docker (défaut `fathyb/carbonyl`) |
|
||
| `CARBONYL_RUNNER` | `docker` (défaut) ou `native` pour appeler `carbonyl` dans le `PATH` |
|
||
|
||
## Scripts
|
||
|
||
- **`./run-carbonyl.sh <url>`** — ouvre l’URL dans Carbonyl.
|
||
- Depuis la racine du monorepo : **`scripts/open-carbonyl-preview-test.sh`** — ouvre l’URL **test** déclarée pour le projet actif (voir ci-dessous).
|
||
|
||
## Prévisualisation des déploiements **test**
|
||
|
||
Dans **`projects/<id>/conf.json`**, sous **`smart_ide`**, champ optionnel **`preview_urls`** :
|
||
|
||
```json
|
||
"preview_urls": {
|
||
"test": "https://app.example.test/"
|
||
}
|
||
```
|
||
|
||
Le script **`scripts/open-carbonyl-preview-test.sh`** lit **`projects/active-project.json`** (ou **`SMART_IDE_PROJECT_ID`**, ou argument **`--project <id>`**) puis **`preview_urls.test`**. En secours : variable **`PREVIEW_TEST_URL`**.
|
||
|
||
**API IDE** : plan d’ouverture d’URL via **`smart-ide-tools-bridge`** — `POST /v1/carbonyl/open-plan` (Bearer) — [docs/API/smart-ide-tools-bridge-api.md](../../docs/API/smart-ide-tools-bridge-api.md).
|
||
|
||
Documentation : [docs/repo/service-carbonyl.md](../../docs/repo/service-carbonyl.md), [docs/features/carbonyl-terminal-browser.md](../../docs/features/carbonyl-terminal-browser.md).
|
||
|
||
## Licence amont
|
||
|
||
Carbonyl est sous licence **BSD-3-Clause** (voir `upstream/license.md`).
|