Sources and Extensibility

Custom Sources & Extensibility

Look reads every .toml file in ~/.look/sources/ (override with LOOK_SOURCES_DIR). Needs Look v0.6.12+. No scripts or plugins required.

Full reference: docs/user-sources.md. Ready-made examples: lookbook.

Quick start

mkdir -p ~/.look/sources
$EDITOR ~/.look/sources/mine.toml

[projects]
name = "Projects"
dir  = "~/dev"
only = "dirs"

[work]
name = "Work setup"
do = [
  "open -a Slack",
  "open -a Safari https://github.com",
]

Reload: Cmd+Shift+; (macOS) / Ctrl+Shift+; (Linux, Windows).

• Type projects → your repos.
• Type work setup → one Enter runs both commands.

Notes

• Any number of files; block ids must be unique across the whole directory.
• Block kinds (do, directory listings, and more) are documented in the full reference.
• Keep sources in a dotfiles repo by pointing LOOK_SOURCES_DIR at it.