AutoConfigOSCLI (v0.1.0)

Professional Environment Automation for Developers. Offline-first. Reversible. Hybrid AI.

---

🚀 Introduction

AutoConfigOSCLI is a command-line tool designed to set up, maintain, and replicate professional development environments across Linux and macOS.

Unlike simple dotfile managers, it provides a holistic approach:

• Context-Aware: Adapts to your hardware (RAM, CPU), machine type (Laptop/Server), and role (Frontend/Backend).
• Tiered Profiles: Choose between Lite (CLI-only), Mid (Balanced), or Full (Batteries-included) stacks.
• Safe & Reversible: Every change is tracked. Built-in audit, backup, and downgrade capabilities.
• Agentless Remote Management: Configure remote servers via SSH without installing persistent agents.

🛡️ Core Principles

1. Offline-First: Core logic, profile resolution, and validation work without internet. AI is an optional layer.
2. Reversible: State is tracked in a local SQLite database. You can roll back changes (downgrade).
3. Idempotent: Running the same command twice is safe.
4. Transparent AI: AI explains, recommends, and verifies, but never executes without your confirmation.
5. Agentless: No background daemons. SSH connections use your native system configuration.

📦 Installation

git clone https://github.com/yourusername/AutoConfigOSCLI.git
cd AutoConfigOSCLI
./init.sh

What init.sh does:

• Checks for Python 3.
• Creates a virtual environment.
• Installs dependencies.
• Links the autoconfigoscli command to your shell (e.g., ~/.local/bin or alias).

What it does NOT do:

• It does NOT install packages on your system.
• It does NOT modify your root files.

🎮 Basic Usage (Safe Demo)

You can explore the tool without making any changes using --dry-run.

1. List Profiles

See all available official profiles:

autoconfigoscli profiles list

2. Inspect a Profile

See exactly what a profile includes:

autoconfigoscli profiles show backend-python-dev-postgresql-mid

3. Dry-Run Install

Simulate an installation to see the exact commands that would be executed:

autoconfigoscli install backend-python-dev-postgresql-mid --dry-run --verbose

Output will show plan: [System] Install python3, [Flatpak] Install vscode, etc.

🏗️ Profiles & Tiers

We strictly categorize profiles to prevent bloat.

Variants:

• PostgreSQL: Includes psql (Lite) or postgresql-server (Mid/Full).
• MongoDB: Includes mongosh (Lite) or compass (Full).

Examples:

• general-dev-lite: Git, Micro, Ripgrep, Htop.
• fullstack-node-dev-postgresql-mid: Node, PNPM, VS Code, Docker, Postgres.

🛠️ User & Manual Mode

Manual Selection

Interactive package picker using FZF:

autoconfigoscli manual

User Profiles

Create your own mix:

autoconfigoscli profiles user create my-custom-stack

🔄 Updates & Backups

Update Tool:

autoconfigoscli update

Restore State: Pass a backup JSON to revert your system state:

autoconfigoscli downgrade --backup ~/.autoconfigos/backups/state_20231020.json

🩺 Diagnostics

• autoconfigoscli doctor: Checks dependencies, internet, and disk space.
• autoconfigoscli audit: Scans your hardware and OS details.
• autoconfigoscli whoami: View/Edit your user identity (Role, Preferences).

🧠 Hybrid AI

Privacy First:

• Local Engine: Recommendations run locally 100% of the time based on RAM/CPU/Role.
• Optional Cloud: You can configure Gemini/OpenAI for "Explain" features.
• PII Scrubbing: Paths (/home/user) and sensitive env vars are scrubbed before sending queries.

# Set Provider (Optional)
autoconfigoscli ai config provider set gemini

# Ask questions
autoconfigoscli ai ask "Why should I use podman instead of docker?"

📡 Remote SSH Management

Manage remote machines as easily as your local one.

# Check remote status
autoconfigoscli remote status user@192.168.1.50

# Install profile remotely (Dry Run)
autoconfigoscli remote install user@server.local backend-python-dev-mongodb-lite --dry-run

Features:

• Bootstrap: Auto-installs git/python if missing.
• Ephemeral: Clones tool to /tmp, executes, and deletes itself.
• Copy Profile: Transfer your local user profile to remote: --copy-user-profile my-stack.

🔒 Security & Trust

• No Credentials: We never ask for or store sudo passwords (sudo handles it).
• No Telemetry: Your data stays on your machine.
• Explicit Confirmation: Destructive actions always strictly require user confirmation.

---

Generated by AutoConfigOSCLI v0.1.0