otty / apps

All apps/Exercism CLI

Exercism CLI

exercism

A Go based command line tool for exercism.org.

Runs as exercism|macOS, Linux, Windows|github.com

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

Exercism CLI in your home directory Every rule on this page, by file

workspace

Each machine keeps its own copy of these.

token

Lifted into your secret store; the rest of the file syncs.

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/exercism/otty.tomlThe file this page is generated from

id = "exercism"

name = "Exercism CLI"

homepage = "https://github.com/exercism/cli"

description = "A Go based command line tool for exercism.org."

icon = "SimpleIcons:exercism"

executables = ["exercism"]

[dotfiles]

# config/config.go Dir(): %APPDATA%\<binary name> on Windows, otherwise

# $EXERCISM_CONFIG_HOME, $XDG_CONFIG_HOME/exercism or ~/.config/exercism — the

# XDG location on macOS too, which is [configHome].

# cmd/configure.go calls viperConfig.SetConfigName("user") and config/persister.go

# writes it as JSON, so the file is user.json.

paths = ["[configHome]/exercism/user.json"]

exclude = []

# user.json is not a whole-file secret: it also carries apibaseurl and the

# workspace setting. Only the token is lifted out.

secret = []

# Loaded once per command through viper.

side_effect = false

# cmd/configure.go: `cfg.Set("token", token)` — the API token from

# exercism.org/settings/api_cli.

[[dotfiles.secret_paths]]

file = "[configHome]/exercism/user.json"

match = { key_path = ["token"] }

# cmd/configure.go runs the workspace through config.Resolve() before storing it,

# which turns it into an absolute path — the directory this machine downloads

# exercises into, and nothing another machine can use. It is where the user's

# own solutions sit, so it is kept for a rebuild of this machine: backup.

[[dotfiles.machine_lines]]

file = "[configHome]/exercism/user.json"

match = { key_path = ["workspace"] }

scope = "backup"

[commands]

format = 1

label = "Exercism"

description = "Download exercises, submit solutions and configure the client."

quality = "ai-draft"

base = "fig:exercism"

parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/exercism.ts"

license = "MIT"

[[commands.subcommand]]

path = ["download"]

label = "Download exercise"

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/exercism.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "exercise"

label = "Exercise slug"

type = "string"

option = ["--exercise", "-e"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "track"

label = "Track"

type = "string"

option = ["--track", "-t"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "team"

label = "Team"

type = "string"

option = ["--team", "-T"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "uuid"

label = "Solution UUID"

type = "string"

option = ["--uuid", "-u"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "download"

label = "Download"

fields = ["exercise", "track"]

required = ["exercise", "track"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["exercise", "track"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["team", "uuid"]

[[commands.subcommand]]

path = ["submit"]

label = "Submit solution"

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/exercism.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "file"

label = "Files"

type = "path"

position = 0

multiple = true

path = { kind = "file", role = "input" }

sources = ["fig"]

[[commands.subcommand.task]]

id = "submit"

label = "Submit"

fields = ["file"]

required = ["file"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["file"]

[[commands.subcommand]]

path = ["configure"]

label = "Configure client"

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/exercism.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "show"

label = "Show current config"

type = "boolean"

option = ["--show", "-s"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "token"

label = "API token"

type = "string"

option = ["--token", "-t"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "workspace"

label = "Workspace"

type = "path"

option = ["--workspace", "-w"]

path = { kind = "directory", role = "output" }

sources = ["fig"]

[[commands.subcommand.field]]

id = "api"

label = "API base URL"

type = "string"

option = ["--api", "-a"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "no_verify"

label = "Skip token check"

type = "boolean"

option = ["--no-verify"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "show"

label = "Show config"

set = { show = [true] }

fields = ["show"]

[[commands.subcommand.task]]

id = "workspace"

label = "Set workspace"

fields = ["workspace", "token"]

required = ["workspace"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["show", "token", "workspace"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["api", "no_verify"]

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/exercism. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page. None of them splits workspace for you — that part is Otty’s own sync, or a template you write by hand.