otty / apps

All apps/IntelliShell

IntelliShell

intelli-shell

A smart command template and snippet manager for shells.

Runs as intelli-shell|macOS, Linux, Windows|github.com

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

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

data_dir

Each machine keeps its own copy of these.

gist.token

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

data_dir

Each machine keeps its own copy of these.

gist.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/intelli-shell/otty.tomlThe file this page is generated from

id = "intelli-shell"

name = "IntelliShell"

homepage = "https://github.com/lasantosr/intelli-shell"

description = "A smart command template and snippet manager for shells."

executables = ["intelli-shell"]

[dotfiles]

# The official default_config.toml documents these exact Linux, macOS and

# Windows paths (and the XDG_CONFIG_HOME override on Unix).

# https://github.com/lasantosr/intelli-shell/blob/main/default_config.toml

paths = [

"[configHome]/intelli-shell/config.toml",

"[appData]/org.IntelliShell.Intelli-Shell/config.toml",

"%APPDATA%/IntelliShell/Intelli-Shell/config/config.toml",

]

exclude = []

secret = []

# The same official default config has [gist].token, a GitHub Personal Access

# Token used for Gist export. Keep other user preferences while excluding only

# that field.

[[dotfiles.secret_paths]]

file = ["[configHome]/intelli-shell/config.toml", "[appData]/org.IntelliShell.Intelli-Shell/config.toml", "%APPDATA%/IntelliShell/Intelli-Shell/config/config.toml"]

match = { key_path = ["gist.token"] }

# data_dir points at the local command database when explicitly configured;

# it is a machine-specific location, not a portable preference.

[[dotfiles.machine_lines]]

file = ["[configHome]/intelli-shell/config.toml", "[appData]/org.IntelliShell.Intelli-Shell/config.toml", "%APPDATA%/IntelliShell/Intelli-Shell/config/config.toml"]

match = { key_path = ["data_dir"] }

scope = "backup"

[commands]

format = 1

label = "IntelliShell"

description = "Search the command library and bookmark new commands. Import, export, replace, fix, config and logs are outside this form."

quality = "ai-draft"

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

[[commands.subcommand]]

path = ["search"]

label = "Search commands"

description = "Print matching stored commands, or open the interactive picker."

[[commands.subcommand.source]]

id = "docs"

kind = "manual"

url = "https://github.com/lasantosr/intelli-shell/blob/main/docs/src/reference/search.md"

revision = "2026-10-27"

evidence = """

intelli-shell search [OPTIONS] [QUERY]

- `-m, --mode <MODE>`

- `auto`: Uses an internal algorithm to best match common search patterns

- `fuzzy`: Finds commands that are similar to the query using special syntax

- `regex`: Treats the query as a regular expression for complex pattern matching

- `exact`: Returns only commands that precisely match the entire query

- `relaxed`: Broadens the search to find the maximum number of potentially relevant commands

- `-u, --user-only` Excludes commands imported from `tldr` pages from the search results.

- `--ai` Uses AI to generate commands based on the `QUERY` prompt

- `-i, --interactive` Opens the interactive TUI to search and select a command.

"""

[[commands.subcommand.field]]

id = "query"

label = "Query"

type = "string"

position = 0

sources = ["docs"]

[[commands.subcommand.field]]

id = "mode"

label = "Search mode"

type = "enum"

choices = [{ value = "auto", label = "Auto" }, { value = "fuzzy", label = "Fuzzy" }, { value = "regex", label = "Regex" }, { value = "exact", label = "Exact" }, { value = "relaxed", label = "Relaxed" }]

option = ["--mode", "-m"]

sources = ["docs"]

[[commands.subcommand.field]]

id = "user_only"

label = "Exclude tldr commands"

type = "boolean"

option = ["--user-only", "-u"]

sources = ["docs"]

[[commands.subcommand.field]]

id = "interactive"

label = "Interactive picker"

type = "boolean"

option = ["--interactive", "-i"]

sources = ["docs"]

[[commands.subcommand.field]]

id = "ai"

label = "Generate with AI"

description = "Treat the query as a natural-language prompt."

type = "boolean"

option = ["--ai"]

sources = ["docs"]

[[commands.subcommand.task]]

id = "find"

label = "Find commands"

fields = ["query", "mode", "user_only"]

required = ["query"]

[[commands.subcommand.task]]

id = "pick"

label = "Pick interactively"

fields = ["query", "interactive"]

required = []

set = { interactive = [true] }

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["query", "mode", "user_only", "interactive", "ai"]

[[commands.subcommand]]

path = ["new"]

label = "Bookmark a command"

description = "Store a new command in the library without opening the TUI."

[[commands.subcommand.source]]

id = "docs"

kind = "manual"

url = "https://github.com/lasantosr/intelli-shell/blob/main/docs/src/reference/new.md"

revision = "2026-10-27"

evidence = """

intelli-shell new [OPTIONS] [COMMAND_STRING]

- `-a, --alias <ALIAS>` Sets an alias (a short, memorable name) for the command.

- `-d, --description <DESCRIPTION>` Provides a detailed description for the command.

- `--ai` Uses AI to generate a command and its description from the `COMMAND_STRING` prompt.

- `-i, --interactive` Opens the interactive TUI to bookmark the command

"""

[[commands.subcommand.field]]

id = "command_string"

label = "Command"

type = "string"

position = 0

sources = ["docs"]

[[commands.subcommand.field]]

id = "alias"

label = "Alias"

type = "string"

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

sources = ["docs"]

[[commands.subcommand.field]]

id = "description"

label = "Description"

description = "May include #tags."

type = "string"

option = ["--description", "-d"]

sources = ["docs"]

[[commands.subcommand.field]]

id = "interactive"

label = "Review in interactive picker"

type = "boolean"

option = ["--interactive", "-i"]

sources = ["docs"]

[[commands.subcommand.field]]

id = "ai"

label = "Generate with AI"

type = "boolean"

option = ["--ai"]

sources = ["docs"]

[[commands.subcommand.task]]

id = "bookmark"

label = "Bookmark a command"

fields = ["command_string", "alias", "description"]

required = ["command_string"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["command_string", "alias", "description", "interactive", "ai"]

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/intelli-shell. 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 data_dir and data_dir for you — that part is Otty’s own sync, or a template you write by hand.