magus v0.3.0 is out. See what's new
¶ View markdown source · ✎ Suggest an edit

magus-where

Print the absolute path of a project

Synopsis

magus where [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.

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-insight(1), magus-graph(1), magus-watch(1), magus-status(1), magus-doctor(1), magus-config(1), magus-server(1), magus-completion(1), magus-man(1), magus-init(1), magus-self(1), magus-version(1)

auto-generatedclimagus wherewhereprojectpathfuzzy matchnavigation
Last updated (a59e71c9)
Earlier changes on this page (2)

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.

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.

Insight

The reports magus derives over the graph and history (hotspots, affinity, ownership, trend). See insight.

Conventions

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