Skip to content

atlas.cli

atlas.cli

Atlas CLI — thin wrapper around the Atlas runtime.

Provides a terminal interface that mirrors the MCP tool's single-string input model. All routing goes through the same Atlas runtime class used by the MCP server.

Usage

atlas # e.g. "atlas python", "atlas init", "atlas add ruff" atlas # prints current status / help

run 

run(raw: str, project_dir: str | None = None) -> int

Parse raw, route to Atlas, print the result.

Returns 0 on success, 1 on error.

Source code in src/atlas/cli.py 
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
def run(raw: str, project_dir: str | None = None) -> int:
    """Parse *raw*, route to Atlas, print the result.

    Returns 0 on success, 1 on error.
    """
    atlas = Atlas(project_dir)
    parsed = parse_input(raw)

    if parsed.verb is None:
        result = atlas.query(parsed.contexts, parsed.message)
    elif parsed.verb == "init":
        result = atlas.init(parsed.args)
    elif parsed.verb == "add":
        result = atlas.add_modules(parsed.args)
    elif parsed.verb in ("create", "edit", "remove") and parsed.resource_type:
        result = atlas.manage_resource(parsed.verb, parsed.resource_type, parsed.args)
    elif parsed.verb == "remove":
        result = atlas.remove_module(parsed.args[0] if parsed.args else "")
    elif parsed.verb == "list":
        result = atlas.list_resources(parsed.args[0] if parsed.args else "all")
    elif parsed.verb == "just":
        result = atlas.just(
            parsed.args[0] if parsed.args else "",
            parsed.args[1:],
        )
    elif parsed.verb == "vcs":
        result = atlas.vcs(parsed.args)
    elif parsed.verb == "crud":
        result = atlas.crud(parsed.args)
    elif parsed.verb == "sync":
        result = atlas.sync(parsed.args)
    else:
        result = error_result("INVALID_ARGUMENT", f"Unknown verb: {parsed.verb}")

    _print_result(result)

    if isinstance(result, dict) and result.get("ok") is False:
        return 1
    return 0

main 

main() -> None

Console script entry point: atlas.

Source code in src/atlas/cli.py 
79
80
81
82
83
84
def main() -> None:
    """Console script entry point: ``atlas``."""
    # Join all CLI arguments as a single space-separated string,
    # matching the MCP tool's single-string-input model.
    raw = " ".join(sys.argv[1:])
    sys.exit(run(raw))