# ⚡ Force Code — Autonomous AI Engineering Agent

> **Force Code** is a state-of-the-art AI-powered CLI designed for elite software engineers. It bypasses the limitations of generic chatbots by giving an AI full agentic control over your local codebase and terminal.

---

## 🚀 Quick Install

To join the elite, install Force Code globally via npm:

```bash
npm install -g forcecode-ai
```

Once installed, navigate to any project and run:

```bash
force
```

## 🛠️ Troubleshooting: 'force' not recognized?

If the command `force` is not recognized after installation, your system's **PATH** might be missing the npm global bin folder.

### **Windows Fix** (Run in PowerShell as Admin):
```powershell
$npmPath = "$env:APPDATA\npm"; $currentPath = [Environment]::GetEnvironmentVariable("Path", "User"); if ($currentPath -notlike "*$npmPath*") { $newPath = "$currentPath;$npmPath"; [Environment]::SetEnvironmentVariable("Path", $newPath, "User"); Write-Host "✅ PATH updated. Please restart terminal." -ForegroundColor Green }
```

### **Linux / macOS Fix**:
```bash
export PATH=$PATH:$(npm config get prefix)/bin
```

---

## 🎨 Platform Features

Force Code is not just a chatbot. It's a senior software architect with 21 specialized engineering skills:

- **🖥️ Computer Use (Agentic)**: Grant the AI full permission to execute tasks on your OS.
- **🧬 Deep Context**: It reads and understands up to 200 files in a single session.
- **🧠 Advanced Reasoning**: Powered by elite reasoning models that architect and distill solutions in real-time.
- **⚡ Zero Overlap**: Passes the "AI Slop Test"—producing code that is impeccable and follows modern design tokens.

---

## 💬 Commands

Interact with the Platform using these core commands:

| Command | Action | Description |
|:---|:---|:---|
| `/models` | ⚙️ Switch Tiers | Toggle between **Powerful**, **Medium**, and **Fast** intelligence. |
| `/computer-use` | 💻 Agentic Mode | Toggle full PC control permissions (ON / OFF). |
| `/usage` | 🔋 Status Report | Check your daily quota and platform limits. |
| `/clean` | 🧹 Reset UI | Clear the terminal screen without losing memory (history). |

---

## 📝 Setup & Configuration

On your first run, Force Code will guide you through a secure login process. Your configuration is stored safely at `config.json` in the root directory:

```json
{
  "apiKey": "fc_...",
  "models": {
    "powerful": "powerful",
    "medium": "medium",
    "fast": "fast"
  },
  "currentModel": "powerful"
}
```

> [!TIP]
> Use the **Powerful** tier for complex architecture and the **Fast** tier for quick code snippets and explanations.

---

## 🧠 Chain-of-Thought
Force Code supports **Thinking Blocks** for models that use reasoning. You see exactly how the AI "thinks" before it writes a single character of code.

---

## 📁 On-Demand Exploration

Force Code doesn't waste time reading your entire project at startup. Instead:

- **Instant Launch**: Starts in milliseconds, even in massive codebases.
- **Agentic Discovery**: The AI dynamically uses `list_files` and `read_file` to explore only what's relevant to your request.
- **Deep Context**: NIM models support massive context (128K+ tokens), allowing the AI to keep all explored files in memory during the session.

---

### ✦ Engineered by Force Code AI Platform
*Elevating Software Engineering through Autonomy.*