CLI संदर्भ

Apothem CLI संदर्भ — सभी उपकमांड और फ़्लैग।

apothem CLI साझा प्रोफ़ाइल और टूल अडैप्टर के प्रबंधन के लिए प्राथमिक ऑपरेटर इंटरफ़ेस है।

ग्लोबल फ़्लैग

फ़्लैग	विवरण
`--version`	Apothem संस्करण प्रिंट करें और बाहर निकलें
`--help`	कमांड के लिए सहायता प्रिंट करें

उपकमांड

`apothem install`

साझा प्रोफ़ाइल से एक टूल अडैप्टर इंस्टॉल करें।

apothem install --harness <name|all> [--profile PATH] [--project PATH] [--dry-run]

विकल्प	विवरण
`--harness <name>`	टूल अडैप्टर का नाम (नीचे विहित मान देखें)। आवश्यक।
`--profile PATH`	साझा प्रोफ़ाइल YAML का पथ। डिफ़ॉल्ट `~/.config/apothem/profile.yaml`।
`--project PATH`	प्रोजेक्ट-दायरे के टूल के लिए प्रोजेक्ट रूट।
`--dry-run`	फ़ाइलें लिखे बिना इंस्टॉल का पूर्वावलोकन करें।

विहित --harness मान:

antigravity
claude-code
codebuddy
codex
cursor
gemini-cli
github-copilot
hermes
kiro
open-claw
opencode
qwen-code
trae
windsurf
zed

रजिस्ट्री-व्यापी सेट चुनने के लिए --harness all --project <path> का उपयोग करें। प्रोफ़ाइल की exclude_harnesses सूची इंस्टॉल/अपडेट बैच चयन के दौरान सम्मानित की जाती है।

`apothem update`

मौजूदा साझा प्रोफ़ाइल से किसी टूल अडैप्टर की नेटिव कॉन्फ़िग को पुनः-व्युत्पन्न करें।

apothem update --harness <name|all> [--profile PATH] [--project PATH] [--dry-run]

विकल्प	विवरण
`--harness <name>`	टूल अडैप्टर का नाम। आवश्यक।
`--profile PATH`	साझा प्रोफ़ाइल YAML का पथ।
`--project PATH`	प्रोजेक्ट-दायरे के टूल के लिए प्रोजेक्ट रूट।
`--dry-run`	फ़ाइलें लिखे बिना अपडेट का पूर्वावलोकन करें।

update टूल आउटपुट को पुनः-मटेरियलाइज़ करता है। यह Apothem CLI पैकेज को अपडेट नहीं करता; पैकेज अपग्रेड के लिए उस पैकेज मैनेजर का उपयोग करें जिसने Apothem इंस्टॉल किया था।

`apothem uninstall`

किसी टूल अडैप्टर की नेटिव कॉन्फ़िग हटाएँ।

apothem uninstall --harness <name|all> [--project PATH] [--yes]

विकल्प	विवरण
`--harness <name>`	टूल अडैप्टर का नाम। आवश्यक।
`--project PATH`	प्रोजेक्ट-दायरे के टूल के लिए प्रोजेक्ट रूट।
`--yes`	पुष्टिकरण संकेत छोड़ें।

`apothem verify`

सत्यापित करें कि कोई टूल अडैप्टर इंस्टॉल है और उसका आउटपुट पथ मौजूद है।

apothem verify --harness <name|all> [--project PATH]

विकल्प	विवरण
`--harness <name>`	टूल अडैप्टर का नाम या `all`। आवश्यक।
`--project PATH`	प्रोजेक्ट-दायरे के टूल के लिए प्रोजेक्ट रूट।

जब अडैप्टर इंस्टॉल होता है तो एग्ज़िट कोड 0 होता है, और जब नहीं होता तो 1।

`apothem profile`

साझा Apothem प्रोफ़ाइल का प्रबंधन करें।

apothem profile show [--profile PATH]
apothem profile init [--profile PATH] [--force]
apothem profile set <key> <value> [--profile PATH]
apothem profile edit [--profile PATH]

उपकमांड	विवरण
`profile init`	एक स्कीमा-वैध न्यूनतम प्रोफ़ाइल स्कैफ़ोल्ड बनाएँ।
`profile show`	हल की गई प्रोफ़ाइल (YAML) को stdout पर प्रिंट करें।
`profile set <key> <value>`	एक प्रोफ़ाइल फ़ील्ड सेट करें। मान YAML-पार्स किया जाता है (स्ट्रिंग, संख्याएँ, बूलियन, सूचियाँ और मैपिंग सभी स्वीकार किए जाते हैं)।
`profile edit`	`$EDITOR` में प्रोफ़ाइल खोलें (प्लेटफ़ॉर्म डिफ़ॉल्ट पर वापस गिरता है)।

--profile PATH विकल्प प्रत्येक उपकमांड को एक वैकल्पिक प्रोफ़ाइल फ़ाइल की ओर इंगित करता है। डिफ़ॉल्ट ~/.config/apothem/profile.yaml।

`apothem harnesses`

पंजीकृत टूल अडैप्टर की सूची बनाएँ और उनका निरीक्षण करें।

apothem harnesses list
apothem harnesses show <name>

उपकमांड	विवरण
`harnesses list`	प्रत्येक पंजीकृत अडैप्टर की एक तालिका उसके इंस्टॉल-स्थिति फ़्लैग और आउटपुट पथ के साथ प्रिंट करें।
`harnesses show <name>`	एक अडैप्टर के लिए नाम, इंस्टॉल स्थिति और आउटपुट पथ प्रिंट करें।

`apothem doctor`

Apothem इंस्टॉलेशन के लिए सिस्टम डायग्नोस्टिक्स चलाएँ।

apothem doctor

Apothem संस्करण, Python इंटरप्रेटर, प्लेटफ़ॉर्म, हल किया गया प्रोफ़ाइल पथ, और एक प्रति-टूल इंस्टॉल-स्थिति तालिका प्रिंट करता है। जब हर पंजीकृत अडैप्टर इंस्टॉल की रिपोर्ट करता है तो एग्ज़िट कोड 0 होता है; अन्यथा 1।

उत्पन्न कमांड और फ़्लैग संदर्भ

Command	Flags	Description
`apothem completion`	—	Print a shell-completion script for SHELL to stdout. Supported shells: bash, zsh, fish, powershell. Every script is generated by Click's env-var completion protocol — PowerShell through the completion class registered above, since Click ships none natively. Enabling completion is opt-in: this command only prints the script — pipe or append it to the shell's completion file yourself (see `--help`).
`apothem diff`	`--format`, `--harness`, `--json`, `--no-color`, `--profile`, `--project`, `--quiet, -q`, `--verbose, -v`	Preview the pending configuration changes for a single harness.
`apothem doctor`	`--format`, `--json`, `--no-color`, `--quiet, -q`, `--verbose, -v`	Report Apothem environment and installation health, exiting non-zero on any failure. Prints the engine version, Python, and platform, validates the shared profile against the packaged schema — a present-but-malformed profile is a failure, not a green "found" — and probes every registered adapter's install state. An adapter that raises degrades to an error row rather than aborting the sweep. Any failed check — an invalid profile, or a harness that is uninstalled or could not be probed — forces a non-zero exit so a CI or setup step can gate on it.
`apothem harnesses list`	`--format`, `--json`, `--no-color`, `--quiet, -q`, `--verbose, -v`	List all registered harness adapters.
`apothem harnesses show`	`--format`, `--json`, `--no-color`, `--quiet, -q`, `--verbose, -v`	Show details for a specific harness adapter.
`apothem install`	`--clean, --fresh`, `--dry-run`, `--format`, `--harness`, `--json`, `--no-color`, `--profile`, `--project`, `--quiet, -q`, `--verbose, -v`, `--yes`	Install a harness adapter configuration.
`apothem migrate-workspace`	`--dry-run`, `--format`, `--json`, `--no-color`, `--project`, `--quiet, -q`, `--verbose, -v`	Migrate a legacy per-harness workspace into the shared `.apothem` layout. The base is the resolved `--project` root when supplied, otherwise the current working directory (the project-local default). Per-harness memory/contexts/learning stores union-merge into the shared store; a conflicting record is skipped, never overwritten; a legacy `.plans` tree moves under `.apothem/plans`; every consumed source is backed up first. The migration is idempotent.
`apothem profile edit`	`--format`, `--json`, `--no-color`, `--profile`, `--quiet, -q`, `--verbose, -v`	Open the shared profile in the system editor.
`apothem profile init`	`--force`, `--format`, `--json`, `--no-color`, `--profile`, `--quiet, -q`, `--verbose, -v`	Create a schema-valid shared profile scaffold.
`apothem profile set`	`--format`, `--json`, `--no-color`, `--profile`, `--quiet, -q`, `--verbose, -v`	Set a key in the shared profile. KEY is a dotted path that descends into the nested profile structure (`identity.name`, `preferences.style`, `enforcement.sprints`, `harnesses.<harness>.preferences.style`); a single key with no dot sets a top-level node. VALUE is stored as a literal string — bare words are not coerced (`no` stays `"no"`, `2024-01-01` and `1.0` stay strings) — except `true`/`false` (the boolean enforcement flags) and explicit `[...]`/`{...}` list/map input. The fully-assembled profile is validated against the packaged schema BEFORE writing; an invalid set is refused with the standard diagnostic and the profile on disk is unchanged.
`apothem profile show`	`--format`, `--json`, `--no-color`, `--profile`, `--quiet, -q`, `--verbose, -v`	Display the current shared profile.
`apothem quickstart`	`--format`, `--harness`, `--json`, `--no-color`, `--profile`, `--project`, `--quiet, -q`, `--verbose, -v`, `--yes`	Guided first run: ensure a profile, preview the writes, then install. Walks a new operator through the canonical path in one linear flow — create a starter profile if none exists (with a personalize nudge), preview the files each harness will write (project root vs your home directory), confirm, then install with the grouped capability-note output — and ends with the recommended next commands. `--yes` runs the whole sequence non-interactively; `--format json` emits one structured summary of every step. It composes the install building blocks; it does not duplicate them.
`apothem rollback`	`--format`, `--harness`, `--install-id`, `--json`, `--last`, `--no-color`, `--project`, `--quiet, -q`, `--verbose, -v`, `--yes`	Restore a harness to the state before its recorded install.
`apothem status`	`--format`, `--json`, `--no-color`, `--profile`, `--project`, `--quiet, -q`, `--verbose, -v`	Report install, verify, and drift state for every registered harness.
`apothem uninstall`	`--format`, `--harness`, `--json`, `--no-color`, `--project`, `--quiet, -q`, `--verbose, -v`, `--yes`	Remove a harness adapter configuration.
`apothem update`	`--dry-run`, `--format`, `--harness`, `--json`, `--no-color`, `--profile`, `--project`, `--quiet, -q`, `--verbose, -v`	Re-install a harness adapter configuration from the current profile.
`apothem verify`	`--format`, `--harness`, `--json`, `--no-color`, `--profile`, `--project`, `--quiet, -q`, `--verbose, -v`	Verify a harness adapter installation. Without `--profile` the check is structural: every managed target must be present and valid. With `--profile` the check additionally requires profile fidelity, so a present-but-drifted install fails verify — answering "is THIS profile faithfully installed?" rather than merely "does it exist?".

CLI संदर्भ

On this page