Aegis documentation

#Tools

Four cubes publish command-line tools the installer built: composer, git, ffmpeg and imagemagick. They share one contract. There is no daemon, so reload always answers no daemon; validate runs the binary once and returns its first version line; expose prints where the binary lives and publishes a wrapper into the shared bin directory (/aegis/bin). The wrapper, not a symlink, exports the cube's LD_LIBRARY_PATH, because the build carries no rpath for its vendored libraries.

None of these cubes has a database, a configuration file it edits, or a destructive verb. composer adds configure because it owns a generated launcher.

#Composer

Composer is a PHP archive, so the cube does not install it globally: configure writes a three-line launcher that executes the platform's own PHP with the phar. The launcher lives in <aegis.root>/config/composer and is published as /aegis/bin/composer, so it always calls the PHP that is actually running.

#configure

bash
aegis cubes composer configureaegis --json cubes composer configure

Writes the launcher, sets mode 0755, and runs it once to prove it works. The phar comes from the installed prefix (bin/composer), the interpreter from the PHP cube's prefix; either missing is reported by name.

text
✔ composer: Composer version 2.11.2 2025-11-06 09:52:31{"ok": true, "cube": "composer", "result": "Composer version 2.11.2 2025-11-06 09:52:31"}

#validate

bash
aegis cubes composer validateaegis --json cubes composer validate

Runs <launcher> --version. Without a launcher it fails with launcher missing: run 'aegis cubes composer configure'.

text
✔ composer: Composer version 2.11.2 2025-11-06 09:52:31{"ok": true, "cube": "composer", "result": "Composer version 2.11.2 2025-11-06 09:52:31"}

#reload

bash
aegis cubes composer reloadaegis --json cubes composer reload

Composer is a tool, not a service; the verb exists for a uniform interface.

text
✔ composer: no daemon{"ok": true, "cube": "composer", "result": "no daemon"}

#expose

bash
aegis cubes composer exposeaegis --json cubes composer expose
text
cube           composerinstalled      /aegis/apps/tools/composer/2.11configuration  /aegis/config/composerlauncher       /aegis/config/composer/composerphar           /aegis/apps/tools/composer/2.11/bin/composerphp            /aegis/apps/web/php/8.5/bin/phppublished      /aegis/bin/composer
text
{"ok": true, "cube": "composer", "installed": "/aegis/apps/tools/composer/2.11", "configuration": "/aegis/config/composer", "launcher": "/aegis/config/composer/composer", "phar": "/aegis/apps/tools/composer/2.11/bin/composer", "php": "/aegis/apps/web/php/8.5/bin/php", "published": "/aegis/bin/composer"}

#help

bash
aegis cubes composer helpaegis cubes help composer
text
ℹ Composer — Composer as published by the platformCommands  configure  Write the launcher and check it  validate   Print the version and check it runs  reload     Nothing to reload; kept for a uniform interface  expose     Show where it is installed and how it runs  help       Show every command with examples

The examples block follows.

#Git

Git is built by the installer together with the TLS libraries it links against. The cube publishes git and answers with its version.

#validate

bash
aegis cubes git validateaegis --json cubes git validate

Runs git --version with the cube environment and returns its first line; a non-zero exit is reported with the last four lines of output.

text
✔ git: git version 2.56.1{"ok": true, "cube": "git", "result": "git version 2.56.1"}

#reload

bash
aegis cubes git reloadaegis --json cubes git reload
text
✔ git: no daemon{"ok": true, "cube": "git", "result": "no daemon"}

#expose

bash
aegis cubes git exposeaegis --json cubes git expose

There is no configuration row: git has no configuration section of its own.

text
cube           gitinstalled      /aegis/apps/tools/git/2.56binary         /aegis/apps/tools/git/2.56/bin/gitpublished      /aegis/bin/git
text
{"ok": true, "cube": "git", "installed": "/aegis/apps/tools/git/2.56", "binary": "/aegis/apps/tools/git/2.56/bin/git", "published": "/aegis/bin/git"}

#help

bash
aegis cubes git helpaegis cubes help git
text
ℹ Git — Git as published by the platformCommands  validate  Print the version and check it runs  reload    Nothing to reload; kept for a uniform interface  expose    Show where it is installed and how it runs  help      Show every command with examples

The examples block follows.

#FFmpeg

FFmpeg and ffprobe are built together. The cube publishes both when they exist; the version comes from -version, not --version.

#validate

bash
aegis cubes ffmpeg validateaegis --json cubes ffmpeg validate

Runs ffmpeg -version and returns the first line, which carries the version and the copyright banner.

text
✔ ffmpeg: ffmpeg version 9.0.2 Copyright (c) 2000-2025 the FFmpeg developers{"ok": true, "cube": "ffmpeg", "result": "ffmpeg version 9.0.2 Copyright (c) 2000-2025 the FFmpeg developers"}

#reload

bash
aegis cubes ffmpeg reloadaegis --json cubes ffmpeg reload
text
✔ ffmpeg: no daemon{"ok": true, "cube": "ffmpeg", "result": "no daemon"}

#expose

bash
aegis cubes ffmpeg exposeaegis --json cubes ffmpeg expose
text
cube           ffmpeginstalled      /aegis/apps/media/ffmpeg/9.0binary         /aegis/apps/media/ffmpeg/9.0/bin/ffmpegpublished      /aegis/bin/ffmpeg, /aegis/bin/ffprobe
text
{"ok": true, "cube": "ffmpeg", "installed": "/aegis/apps/media/ffmpeg/9.0", "binary": "/aegis/apps/media/ffmpeg/9.0/bin/ffmpeg", "published": "/aegis/bin/ffmpeg, /aegis/bin/ffprobe"}

#help

bash
aegis cubes ffmpeg helpaegis cubes help ffmpeg
text
ℹ Ffmpeg — FFmpeg tools as published by the platformCommands  validate  Print the version and check it runs  reload    Nothing to reload; kept for a uniform interface  expose    Show where it is installed and how it runs  help      Show every command with examples

The examples block follows.

#ImageMagick

The cube publishes magick, and the classic convert and identify names when the build ships them. The version comes from magick -version.

#validate

bash
aegis cubes imagemagick validateaegis --json cubes imagemagick validate
text
✔ imagemagick: Version: ImageMagick 7.1.2-35 Q16-HDRI x86_64 22450 https://imagemagick.org{"ok": true, "cube": "imagemagick", "result": "Version: ImageMagick 7.1.2-35 Q16-HDRI x86_64 22450 https://imagemagick.org"}

#reload

bash
aegis cubes imagemagick reloadaegis --json cubes imagemagick reload
text
✔ imagemagick: no daemon{"ok": true, "cube": "imagemagick", "result": "no daemon"}

#expose

bash
aegis cubes imagemagick exposeaegis --json cubes imagemagick expose
text
cube           imagemagickinstalled      /aegis/apps/media/imagemagick/7.1binary         /aegis/apps/media/imagemagick/7.1/bin/magickpublished      /aegis/bin/magick, /aegis/bin/convert, /aegis/bin/identify
text
{"ok": true, "cube": "imagemagick", "installed": "/aegis/apps/media/imagemagick/7.1", "binary": "/aegis/apps/media/imagemagick/7.1/bin/magick", "published": "/aegis/bin/magick, /aegis/bin/convert, /aegis/bin/identify"}

#help

bash
aegis cubes imagemagick helpaegis cubes help imagemagick
text
ℹ Imagemagick — ImageMagick as published by the platformCommands  validate  Print the version and check it runs  reload    Nothing to reload; kept for a uniform interface  expose    Show where it is installed and how it runs  help      Show every command with examples

The examples block follows.