acton up

Synopsis

acton up [options] [version]

Description

Download and install a published Acton release for the current target triple.

By default, stable builds update to the latest stable release. Trunk builds stay on the trunk channel unless --stable is passed explicitly.

The updater fetches release metadata from GitHub, downloads the matching archive and SHA256 checksum, verifies the checksum, and replaces the current binary.

Options

Update Options

Specific version tag to install.

--trunk

Install the most recent trunk release.

--stable

Install the latest stable release.

--force

Install the selected release even if Acton is already up to date.

--list

List available release tags and exit.

Display Options

--color<when>

Control when to use colored output.

Possible values:

auto, always, never

Project Options

--manifest-path<path>

Pass-through:

Accepted as a global Acton option for CLI consistency.

This command does not require an existing project manifest for its primary workflow. It remains mutually exclusive with --project-root.

--project-root<path>

Pass-through:

Accepted as a global Acton option for CLI consistency.

This command does not require an existing project root for its primary workflow. It remains mutually exclusive with --manifest-path.

Release Sources

Acton queries GitHub release metadata and assets from:

ton-blockchain/acton
i582/acton-public

If GITHUB_TOKEN is set, Acton uses it for authenticated GitHub API requests.

Installation Flow

When installing a release, Acton:

selects the archive matching the current target triple
downloads the archive and its .sha256 file
verifies the SHA256 digest
unpacks the archive
replaces the current acton binary

acton up --list is read-only and skips download or replacement.

Interactivity

--force bypasses the usual up-to-date short-circuit for the selected release
up-to-date checks and --list can succeed without making local changes

Channel Selection

acton up on a stable build updates to the latest stable release
acton up on a trunk build stays on trunk
acton up --stable switches a trunk build back to stable
acton up --trunk switches to the trunk channel
acton up <version> installs the explicit version even if it is older or newer than the current one

Exit Status

0: The requested release information was listed, Acton was already up to date, or the selected version was installed successfully.
1: Release lookup failed, checksum verification failed, or archive replacement failed.

Examples

Update to the latest stable release:
```
acton up
```
Switch to the trunk channel:
```
acton up --trunk
```
Install a specific version:
```
acton up 0.1.0
```
List available releases:
```
acton up --list
```
Reinstall the currently selected channel version:
```
acton up --force
```
Update to the latest stable release explicitly:
```
acton up --stable
```