magus-where

Print the absolute path of a project

Synopsis

magus where [flags] [filter...]

Description

Fuzzy-match a project by leaf-anchored substring and print its absolute path to stdout. Designed for shell substitution:

cd "$(magus where api)" code "$(magus where dash)"

Filters are AND-combined substrings. On a unique top score the path is printed and the command exits 0. On ambiguity, candidates are listed on stderr and the command exits 2. No interactive picker - use magus x for that.

Options

-A

Short for --all

--all

Print all matching paths to stdout; do not error on ambiguity

--filter string

Restrict file search by pattern. Form: type=<glob|regex|literal>,pattern=<value>

--glob string

Restrict file search to paths matching a doublestar glob (shorthand for --filter type=glob,...)

--literal string

Restrict file search to paths containing this exact segment (shorthand for --filter type=literal,...)

--regex string

Restrict file search to paths matching a Go regexp (shorthand for --filter type=regex,...)

Examples

Navigate to a project

cd "$(magus where api)"

Open in editor

code "$(magus where dash)"

AND-filter: must match both tokens

magus where api gateway

See Also

magus(1), magus-ls(1), magus-describe(1), magus-run(1), magus-x(1), magus-affected(1), magus-graph(1), magus-query(1), magus-explain(1), magus-path(1), magus-refs(1), magus-watch(1), magus-events(1), magus-status(1), magus-clean(1), magus-shell(1), magus-vcs(1), magus-queue(1), magus-doctor(1), magus-config(1), magus-session(1), magus-memory(1), magus-job(1), magus-notes(1), magus-diff(1), magus-server(1), magus-broker(1), magus-mcp(1), magus-buzz(1), magus-completion(1), magus-man(1), magus-init(1), magus-spell(1), magus-agent(1), magus-self(1), magus-version(1)