Installation

Tinka has two Commands you install with Go’s own tooling: the Tinka CLI, tinka, creates Apps and reads the docs, and act runs Commands inside an App. It needs Go 1.27 or later; check with go version.

Install

Install the latest release:

go install github.com/mucolabs/tinka/cmd/tinka@latest

Go places the binary in $(go env GOPATH)/bin. Make sure that directory is on your PATH.

Check the installation

Run tinka version:

tinka version

tinka v1.0.0-alpha.1 (go1.27.2, linux/amd64)

When an agent runs the same Command, it gets one JSON line instead. Add --json to see it yourself:

tinka version --json

{"command":"version","result":"ok","version":"v1.0.0-alpha.1","go":"go1.27.2","platform":"linux/amd64","duration_ms":0}

See Agent mode output for the full format.

Install act

act runs Commands inside an App, such as act generate:key. tinka creates Apps and reads the docs; act works in the App's directory. Install it the same way:

go install github.com/mucolabs/tinka/cmd/act@latest

Check it with act --version, and list its Commands with act --help:

act --help

Run an App's Commands

Usage:
  act <command> [flags]

Commands:
  generate:key  Generate a random APP_KEY and write it to .env

Flags:
  -h, --help     Show help
      --json     Print a single JSON result instead of text
      --version  Print the version