You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This skill ensures that VibeAuracle maintains its "Modular Monolith" structure and Hexagonal Architecture principles.
4
+
5
+
## 🎯 Objective
6
+
Prevent tight coupling between the cognitive core (`brain`) and infrastructure adapters (UI, Providers, Tools).
7
+
8
+
## 🛠️ Instructions
9
+
10
+
### 1. Hexagonal Boundaries
11
+
-**Core Logic**: Keep `internal/brain` pure. It should define interfaces for what it needs, not import specific implementations from `internal/model` or `internal/sys` unless necessary for types.
12
+
-**Dependency Inversion**: Use factories or registry patterns (see `internal/model/model.go`) to inject dependencies.
13
+
14
+
### 2. Workspace Hygiene
15
+
- When adding new capabilities, consider if they belong in an existing module or deserve a new subdirectory in `internal/`.
16
+
- Maintain `go.work` consistency.
17
+
18
+
### 3. TUI Decoupling
19
+
- The UI (`cmd/vibeaura/chat_ui.go`) should strictly be a consumer of the Brain's output.
20
+
- Avoid putting business logic or tool execution logic directly into the TUI's `Update` function.
21
+
22
+
## ✅ Verification
23
+
- Check for circular dependencies using `go list`.
24
+
- Ensure new features are accompanied by tests in the relevant module.
This skill manages the "Doctor" system that automatically detects and resolves project issues.
4
+
5
+
## 🎯 Objective
6
+
Create a resilient engineering environment where the AI proactively fixes its own errors or system inconsistencies.
7
+
8
+
## 🛠️ Instructions
9
+
10
+
### 1. Issue Detection
11
+
- Monitor the `doctor` channel for signals from various modules (Brain, TUI, Tooling).
12
+
- Implement specialized "Healers" in `internal/doctor` for common failure modes (e.g., build errors, git conflicts).
13
+
14
+
### 2. Recursive Correction
15
+
- When an execution fails (e.g., `shell_exec` returns non-zero), the Brain should invoke the `self-healing` logic to analyze the error and generate a fix.
16
+
- Ensure loop detection is active to prevent infinite retry-fail cycles.
17
+
18
+
### 3. Safety First
19
+
- Self-healing actions that involve significant filesystem changes or destructive commands MUST require user intervention/approval.
20
+
21
+
## ✅ Verification
22
+
- Test healers with simulated failures (see `internal/brain/self_healing.go`).
23
+
- Ensure the `doctor` successfully routes issues to the active agent runtime.
Welcome, Agent. You are operating within **VibeAuracle**, a Distributed, System-Intimate AI Engineering Ecosystem. This project is built by and for AI-augmented engineers who value deep integration with the underlying operating system and hardware.
4
+
5
+
## 🌌 Project Essence
6
+
7
+
VibeAuracle is not just a CLI; it's a "God-tier" engineering companion that unifies the terminal, the IDE, and the AI assistant into a single, keyboard-centric experience.
8
+
9
+
### Core Philosophy
10
+
1.**System Intimacy**: The agent must be aware of the environment (CWD, CPU, VRAM, OS) before suggesting or taking action.
11
+
2.**Modular Runtimes**: We support multiple agentic engines (Internal Vibe loop, official Copilot SDK, and custom personas).
12
+
3.**Keyboard-First**: The UI (TUI) is optimized for speed and fluidity, using the Bubble Tea framework.
13
+
4.**Hexagonal Architecture**: The core logic (`internal/brain`) is decoupled from adapters (providers, tools, UI) to allow infinite extensibility.
14
+
15
+
## 🛠️ Development Guidelines
16
+
17
+
### For AI & Human Contributors
18
+
-**No Binaries in Git**: NEVER commit binaries, executables, or build artifacts to the repository.
19
+
-**Build Isolation**: All local builds must be directed to the `/build/` directory (which is git-ignored). Create the directory if it does not exist.
20
+
-**Strict Go Patterns**: We use Go 1.25+ Workspaces. Maintain decoupling between modules.
21
+
-**Security First**: Never expose secrets. Use the `vault` module. Tool execution requires explicit intent awareness.
22
+
-**TUI Integrity**: UI changes must adhere to the Bubble Tea (TEA) pattern. Styling is done via Lipgloss.
23
+
-**Agentic Responsibility**: When acting as an agent, prioritize `executeToolCalls` for multi-step tasks. Use the official Copilot SDK runtime (`/agent /sdk`) for high-stakes engineering.
24
+
25
+
## 🧠 Specialized Skills
26
+
27
+
We maintain localized expertise in `.agent/skills/`. Refer to these for specific domain knowledge:
28
+
29
+
1.**arch-integrity**: Maintaining the modular monolith and hexagonal boundaries.
30
+
2.**sys-intimacy**: Leveraging and extending the system monitoring and filesystem abstraction.
31
+
3.**self-healing**: Implementing and refining the recursive doctor/healer loop.
32
+
33
+
## 🗺️ Architectural Mapping
34
+
35
+
-`cmd/vibeaura`: The TUI and CLI entry point.
36
+
-`internal/brain`: The cognitive orchestrator (The Brain).
37
+
-`internal/copilot`: Bridge to the official GitHub Copilot SDK.
38
+
-`internal/sys`: Hardware awareness and filesystem abstraction.
39
+
-`internal/model`: Unified interface for multiple AI providers (Ollama, OpenAI, GitHub).
40
+
-`pkg/vibe`: Public SDK for extensions.
41
+
42
+
---
43
+
*"We build tools that feel like an extension of the mind, not just the hands."*
**Distributed, System-Intimate AI Engineering Ecosystem**
5
+
**Aura vibe with the coolest CLI coding oracle**
6
+
7
+
*VibeAuracle aims for total model-intimacy: a unified gateway for every AI in existence—from Claude Code and Copilot to its native Auracle agent.*
8
+
9
+
> [!IMPORTANT]
10
+
> **🔮 AURACLE MODE**: Press `Ctrl + Y` to enable an autonomous, human-like agentic loop that independently analyzes and improves your repository. It assumes its own personality to handle issues and patterns with zero user interference.
> **Trust but Verify:** You can always clone and build manually from source, or download our pre-built releases. Every release is built directly from source via GitHub Actions and includes checksums for security.
36
+
37
+
> **Pro Tip:** One install is all you need. It auto-updates by default, so you only really need `vibeaura update` if you somehow went through the trouble of disabling its autonomy.
38
+
39
+
---
40
+
41
+
## 🧠 Why? (The Motivation)
42
+
There are lots of reasons—some selfish—for me building this. I realized I spend so much time coding and wanted to optimize for three reasons:
43
+
44
+
1.**Agentic Future**: It will clearly be the future of software development.
45
+
2.**Speed**: Models will always be faster than humans. In human history, speed has always been a factor for 90% of innovation.
46
+
3.**Control**: I code so much I need to control what goes within the tools I use, instead of blindly relying on closed source tools.
47
+
48
+
Vibeaura is a lifelong project for me. Almost a decade ago, I told my brother "passive productivity" was the goal—I want to be able to work in my sleep. Coming from a mathematics and computer science background, building this is my pursuit of that ultimate efficiency.
49
+
50
+
> [!TIP]
51
+
> **Why Go?**: I simply love the ease of development and distribution. When I head to a project, the first thing I look for is how clean and easy it is to install and uninstall. That’s why I went through the trouble of implementing one of the most sophisticated distribution, install, update, and uninstall pipelines possible; you need not think; just install and start vibing.
52
+
53
+
---
54
+
17
55
## 🌌 The Vision
18
56
**vibe auracle** unifies the terminal, the IDE, and the AI assistant into a single, keyboard-centric interface. It's built for engineers who value **system-intimacy**—where the AI isn't just a chatbot, but a co-pilot with deep access to your hardware, configuration, and environment.
19
57
20
58
## 🤖 Modular Agentic Runtimes
21
59
VibeAuracle is a multi-engine orchestrator. Choose the runtime that fits your task:
22
60
23
-
-**🎨 Vibe Agent (`/agent /vibe`)**: Our artisan internal loop. Highly transparent, uses custom heuristic loop-detection, and optimized for system-intimate tasks.
-**🚀 Copilot SDK Agent (`/agent /sdk`)**: Native GitHub Copilot SDK runtime. Delegates multi-step reasoning to the official GitHub agentic engine for deep tool-intimacy and secure, high-stakes engineering.
25
-
-**👤 Custom Agent (`/agent /custom`)**: User-defined agent personas. Register specialized agents with custom system prompts and restricted toolsets to create focused experts for specific workflows.
63
+
> *I say **native** out of gratitude: coming from a third-world country, the GitHub Education plan provided tools I could never have afforded, giving me the headstart that made me who I am today.*
64
+
-**🌌 Agentic Vibes (`/agent /custom`)**: Specialized **Vibes** that come with their own agentic capabilities. Register specialized personas with custom system prompts and restricted toolsets to create focused experts for specific workflows.
26
65
27
66
Use the `/agent` command in the TUI to toggle between engines on the fly.
28
67
@@ -35,22 +74,6 @@ Use the `/agent` command in the TUI to toggle between engines on the fly.
35
74
36
75
---
37
76
38
-
## 🚀 Quick Install
39
-
40
-
### 🐧 Linux / 🍎 macOS / 🤖 Android
41
-
```bash
42
-
curl -fsSL https://raw.githubusercontent.com/nathfavour/vibeauracle/release/install.sh | sh
0 commit comments