LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

setup-ai

Alias for local-coder, which configures a local OpenCode agent team on Ollama

TLDR

Preview setup without writing files or downloading models
$ setup-ai --dry-run
copy
Run interactive setup
$ setup-ai
copy
Use the minimal preset without prompts
$ setup-ai --yes --preset minimal
copy
Configure the current project
$ setup-ai --project
copy
Show recorded setup
$ setup-ai status
copy
Uninstall preview
$ setup-ai uninstall --dry-run
copy

SYNOPSIS

setup-ai [setup|configure|reinstall|uninstall|status|models] [options]setup-ai verify-contract contract.json [--root path] [--baseline json] [--changed path ...]

DESCRIPTION

setup-ai is the second bin name of local-coder. After npm link in a checkout of that repository, both names point at the same Node.js script. Subcommands, flags, and exit codes match.With no subcommand it runs setup: detect the machine, assign local Ollama models to OpenCode roles, write permission-restricted agent files, and probe whether those models can call tools and survive an edit-and-verify run. status, models, reinstall, uninstall, and verify-contract behave as they do under local-coder.

PARAMETERS

--dry-run

Print the plan and exit.
--yes, -y
Accept defaults without interactive confirmation.
--preset balanced|quality|fast|minimal
Choose a model mix. minimal uses one model for every role.
--project [path]
Use <path>/.opencode instead of ~/.config/opencode.
--no-pull
Do not download models.
--backup
Back up generated files before --yes replaces them.
--skip-validation
Skip inference and runtime probes.
-h, --help
Print usage. The text says local-coder, which is the name hardcoded in the program.

CAVEATS

The help banner always prints local-coder, including when argv[0] is setup-ai. Requirements are the same as local-coder: macOS or Linux, Node.js 20 or newer, Ollama, and OpenCode. There is no separate setup-ai package on the npm registry.

HISTORY

The alias is declared in the local-coder package bin map. That project was published in September 2026 and is licensed under MIT.

SEE ALSO

local-coder(1), opencode(1), ollama(1), npm(1)

RESOURCES

Copied to clipboard
Kai