Elide for AI Agents — Elide Docs

Elide detects common agent harnesses and switches to plain, non-interactive output. Set ELIDE_AGENT=1 to request that behavior explicitly.

Recommended invocation

NO_COLOR=1 ELIDE_LOG=warn ELIDE_ERROR_FORMAT=plain CI=1 \
  elide --ignore-version --timeout=120s <command>

--ignore-version prevents a project .elideversion from delegating to a different binary.
--timeout exits with code 124 when guest execution exceeds the limit.
ELIDE_ERROR_FORMAT=plain keeps program output on stdout and uncaught errors on stderr.
Add --no-tui to serve and dev.
--quiet silences progress and diagnostics only; manifest and project still print their payload.

Useful commands

Command	Use
`elide run <file>`	Run a program; script arguments follow `--`.
`elide python <file>`	Use Python-style argument handling.
`elide build --inspect`	Discover project task names.
`elide test <path>`	Run tests; sequential unless `--concurrency` is raised.
`elide manifest`	Print the resolved manifest as JSON.
`elide classpath <sourceSet>:<usage>`	Print a resolved classpath, e.g. `test:runtime`.
`elide install`	Install Maven dependencies.
`elide install --ecosystems=npm`	Install npm dependencies.
`elide help <topic> --format=markdown`	Print one embedded documentation topic.

--with=sources and --with sources are accepted by elide install. The colon form --with:sources is not accepted.

elide format --list-files -- --dry-run <path> checks formatting without writing and names the files that would change. It exits 1 on its own when any of them would; --set-exit-if-changed is accepted for parity with the underlying formatters but is not required, and there is no --check.

Running a script

elide run <script> resolves <script> in this order:

An inline snippet, when -s, --snippet or --code is present.
A file that exists — .java and .kt compile and run on the JVM, other supported extensions run as guest code.
A named script, when no such file exists: scripts in elide.pkl, then a package.json script, then a pyproject.toml entry point, then a node_modules/.bin binary.
The project entrypoint, for a bare elide run with no file: entrypoint from elide.pkl, then jvm.main.

A name that resolves to none of these is a usage error, not a failed program; the error lists every location searched.

Exit codes

Code	Meaning
`0`	Success.
`1`	A command or guest program ran and failed.
`2`	Invalid usage or an unresolved run target.
`124`	The global timeout expired.

Diagnostics and bug reports

elide agent diagnostics
elide agent diagnostics --json
elide agent bug

Diagnostics include the resolved crash-report directory. agent bug prints a report body and issue URL; it does not submit anything.