CLI & Terminal Commands Quick Reference

This reference aggregates verified command snippets, setup sequences, and tool executions across the DSOM framework.

1. Environment & Package Management (uv)

Install uv Dependency Manager

# Official installer (recommended)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Verify installation
uv --version

# Windows PowerShell installer
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Verify installation
uv --version

Install DSOM Guardrails

# Standard installation
uv add guardrails-ai-dsom

# With optional Guardrails AI and Token dependencies
uv add "guardrails-ai-dsom[all]"

---

2. FastMCP Server & Knowledge Retrieval

Launch FastMCP Server

# Run server over stdio
uv run tools/mcp/server.py

Search Code Snippets via FastMCP

Use the search_code_snippets tool inside Cursor, Claude Desktop, or your MCP client:

{
  "query": "ansible",
  "limit": 3
}

---

3. Git Rituals & Guardrails Installation

Initialize Git and Install Guardrails Hook

git init
git branch -M main

# Install unbypassable pre-commit guardrail hook
uv run python tools/install_git_guardrails.py

Safe Multi-Remote Git Ritual

# Non-interactive multi-remote push
$env:GIT_TERMINAL_PROMPT="0"
$env:GCM_INTERACTIVE="never"
git push origin main
git push gitlab main

---

4. Documentation Compilation & Sync

Local Mintlify Preview

cd docs-source
npm i -g mint
mint dev

Compile Markdown to MDX

python tools/build_mintlify_mdx.py

Run Dry-Run Sync Validation

python scripts/sync_docs.py --dry-run

---

5. Control Node & System Automation

Setup WSL AlmaLinux 10 Control Node

# Run automated setup from repository root
.\tools\setup-wsl-almalinux10.ps1

Hardening & Control Node Provisioning

# Inside WSL / Linux instance with root privileges
bash tools/setup-dsom-control-node.sh

Verify Ansible Baseline Connectivity

ansible --version
ansible localhost -m ping
ansible all -m ping -i inventory/hosts.yml

---

Deep State of Mind (DSOM) For My AI Protocol | Harisfazillah Jamel (LinuxMalaysia) | 2026-08-23 Standard: UK English | DBP-standard Bahasa Melayu Malaysia (Piawai) | GNU General Public License v3.0