The Archive · CLI reference · Commands

talos forge

Tools created by TALOS during a session: inspect, validate, scan, simulate, install, versions, rollback.

Reference for TALOS CLI 0.3.3 generated from the npm package · released Sep 30, 2026

TALOS CLI 0.5.2 is out; this page still describes 0.3.3 and updates with the next build.

The Forge lets TALOS build a new tool as a package: a declarative manifest (id, title, description, input schema and a flow of capability, if, return and fail nodes) with a sample input for simulation. Before use, a package is validated, scanned and simulated; installing it belongs to a session. <package.json> is a Forge package file.

Operation	What it does
`list`default	Lists the forged tools.
`inspect`	Prints one forged tool.
`validate`	Checks that a package is well formed.
`scan`	Checks the manifest against the Forge language: any field or flow node outside it is a blocking finding.
`simulate`	Runs the flow on the package's sample input with the capability results it declares — no side effects — and prints the trace and the capabilities it asked for.
`install`	Installs a package for a session.
`versions`	Lists the revisions of a forged tool.
`rollback`	Goes back to an earlier revision of a forged tool.
`enable`	Enables a forged tool.
`disable`	Disables a forged tool.

Without an operation, talos forge runs list.

`list`

Lists the forged tools.

talos forge list

`inspect`

Prints one forged tool.

talos forge inspect <id>

Arguments

id: The id talos forge list shows.

`validate`

Checks that a package is well formed.

talos forge validate <package.json>

Arguments

package.json: A Forge package file (JSON).

`scan`

Checks the manifest against the Forge language: any field or flow node outside it is a blocking finding.

talos forge scan <package.json>

Arguments

package.json: A Forge package file (JSON).

`simulate`

Runs the flow on the package's sample input with the capability results it declares — no side effects — and prints the trace and the capabilities it asked for.

talos forge simulate <package.json>

Arguments

package.json: A Forge package file (JSON).

`install`

Installs a package for a session.

talos forge install <package.json> --session <session-id>

Arguments

package.json: A Forge package file (JSON).

Options

--session <value>: The session that owns the tool (required).

Exit codes and errors1

Code	Exit	Meaning
`FORGE_SESSION_REQUIRED`	`15`	The session could not be used. Pick a session from the list.

`versions`

Lists the revisions of a forged tool.

talos forge versions <id> --session <session-id>

Arguments

id: The id talos forge list shows.

Options

--session <value>: The owning session (required).

Exit codes and errors1

Code	Exit	Meaning
`FORGE_SESSION_REQUIRED`	`15`	The session could not be used. Pick a session from the list.

`rollback`

Goes back to an earlier revision of a forged tool.

talos forge rollback <id> <revision> --session <session-id>

Arguments

id: Tool id.
revision: Revision number, 1 or higher.

Options

--session <value>: The owning session (required).

Exit codes and errors2

Code	Exit	Meaning
`FORGE_REVISION_INVALID`	`2`	The command or the configuration is not valid. Check the command, its options and the configuration.
`FORGE_SESSION_REQUIRED`	`15`	The session could not be used. Pick a session from the list.

`enable`

Enables a forged tool.

talos forge enable <id> [--session <session-id>]

Arguments

id: The id talos forge list shows.

Options

--session <value>: Enable it through the owning session.

`disable`

Disables a forged tool.

talos forge disable <id> [--session <session-id>]

Arguments

id: The id talos forge list shows.

Options

--session <value>: Disable it through the owning session.