magus v0.4.2 is out. See what's new
¶ View generated markdown
1 min read

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-vcs(1), magus-doctor(1), magus-config(1), magus-session(1), magus-memory(1), magus-notes(1), magus-diff(1), magus-server(1), magus-mcp(1), magus-buzz(1), magus-completion(1), magus-man(1), magus-init(1), magus-agent(1), magus-self(1), magus-version(1)

generatedinternal/cli/registry.goclimagus wherewhereprojectpathfuzzy matchnavigation
Last updated (4f8cc295)
Earlier changes on this page (7)

Full history ↗ · Blame source ↗

Glossary

Project

A directory magus recognizes as a unit of work (it has a magusfile); the unit of caching, scheduling, and dependency tracking. See workspace.

Op

A single tool-native command a target composes (long form: operation); the middle of the work hierarchy (Spell to Op to Target). See operations.

Buzz

The language magusfiles are written in (the .buzz engine). See engines.

Affected

The set of projects touched by a change; magus affected <target> runs a target only over them. See affected.

MAGUS.md

The committed routing index at a workspace root, regenerated from the knowledge graph: it lists every node and points at the exact query for a given question, so it is the entry point an agent reads first. See knowledge.

Session

One magus process's recorded facts - the targets it finished, their outcomes, and the lease it acted as - kept in a repo-scoped store every worktree shares. magus session lists them; the store prunes itself by last-fact age.

Conventions

This page uses none of the site's convention markers. The full set is on the conventions page.