vibecode 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 67b457d6b47865f6c66f355bb323d6540ec2a7610629cbc930e8633fdb08a262
+  data.tar.gz: bada201bbd50182d4f047e66e6421a96f189907b51d2116545325793237414cc
+SHA512:
+  metadata.gz: 7e0903ba7b4ba6498469de22a6bdbe95caa0449f1fa7fc1169a8a71ef0e011bd848fcf53c3ff8583dffb4f30ff40fdb286e3759f90b34c91736cdba616465754
+  data.tar.gz: 50d556a5e712d67f1279057cca0e79d889b20f0ca508b73e4f82b8cbab992d73f1e9b77889d1761e5a429a1954cb618a86a77a7338e87b52dec7251dd1ae9bce

data/.gitignore

@@ -0,0 +1,33 @@
+# Bundler
+/.bundle/
+
+# Yard docs
+/.yardoc
+/_yardoc/
+/doc/
+
+# Coverage
+/coverage/
+
+# Build artifacts
+/pkg/
+
+# Test reports
+/spec/reports/
+
+# Temp files
+/tmp/
+
+# macOS
+.DS_Store
+
+# Vim / editors
+*.swp
+*.swo
+
+# Logs
+*.log
+
+.vibecode/
+config.json
+

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2026-02-01
+
+- Initial release

data/Gemfile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in vibecode.gemspec
+gemspec
+
+gem "rake", "~> 13.0"
+
+gem "minitest", "~> 5.16"

data/Gemfile.lock

@@ -0,0 +1,56 @@
+PATH
+  remote: .
+  specs:
+    vibecode (0.1.0)
+      diffy
+      httparty
+      json
+      open3
+      pastel
+      tty-prompt
+      tty-spinner
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    bigdecimal (4.0.1)
+    csv (3.3.5)
+    diffy (3.4.4)
+    httparty (0.24.2)
+      csv
+      mini_mime (>= 1.0.0)
+      multi_xml (>= 0.5.2)
+    json (2.18.0)
+    mini_mime (1.1.5)
+    minitest (5.27.0)
+    multi_xml (0.8.1)
+      bigdecimal (>= 3.1, < 5)
+    open3 (0.2.1)
+    pastel (0.8.0)
+      tty-color (~> 0.5)
+    rake (13.3.1)
+    tty-color (0.6.0)
+    tty-cursor (0.7.1)
+    tty-prompt (0.23.1)
+      pastel (~> 0.8)
+      tty-reader (~> 0.8)
+    tty-reader (0.9.0)
+      tty-cursor (~> 0.7)
+      tty-screen (~> 0.8)
+      wisper (~> 2.0)
+    tty-screen (0.8.2)
+    tty-spinner (0.9.3)
+      tty-cursor (~> 0.7)
+    wisper (2.0.1)
+
+PLATFORMS
+  arm64-darwin-25
+  ruby
+
+DEPENDENCIES
+  minitest (~> 5.16)
+  rake (~> 13.0)
+  vibecode!
+
+BUNDLED WITH
+   2.5.23

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Kurt Tamulonis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,245 @@
+# Vibecode
+
+**Vibecode** is a terminal-based AI coding agent powered by local LLMs through [Ollama](https://ollama.com). It can read your project files, propose edits with diffs, and run Git commands — all with your approval.
+
+Think of it as a **local, open-source Codex-style coding assistant** that runs directly in your terminal.
+
+---
+
+## ✨ Features
+
+* 🧠 Uses local coding models via Ollama
+* 📂 Reads and understands your current project directory
+* ✏️ Proposes file edits with colorized diffs
+* 🔒 Asks before modifying files or running Git commands
+* 🌿 Git-aware (status, branches, commits, push, etc.)
+* 🔄 Switch models anytime
+
+---
+
+## 🧰 Requirements
+
+Before installing Vibecode, make sure you have:
+
+* **Ruby 3.0+**
+* **Bundler**
+* **Git**
+* **Ollama** installed and working
+
+Install Ollama from:
+
+👉 [https://ollama.com/download](https://ollama.com/download)
+
+Start the Ollama server:
+
+```bash
+ollama serve
+```
+
+---
+
+## 🚀 Local Installation (Development Mode)
+
+From the Vibecode project directory:
+
+```bash
+bundle install
+chmod +x exe/vibecode
+```
+
+Run directly without installing the gem:
+
+```bash
+bundle exec exe/vibecode
+```
+
+---
+
+## 📦 Install as a Local Gem
+
+From the project root:
+
+```bash
+gem build vibecode.gemspec
+gem install ./vibecode-*.gem
+```
+
+Then you can run from anywhere:
+
+```bash
+vibecode
+```
+
+---
+
+## 🩺 System Check
+
+Verify everything is connected properly:
+
+```bash
+vibecode -doctor
+```
+
+You should see:
+
+```
+Ollama installed            OK
+Ollama server running       OK
+Git installed               OK
+```
+
+---
+
+## 🤖 Managing Models
+
+### List installed models
+
+```bash
+vibecode -list
+```
+
+### Use a model (auto-pulls if missing)
+
+```bash
+vibecode -use qwen2.5-coder:7b
+```
+
+### Manually pull a model
+
+```bash
+vibecode -pull deepseek-coder:6.7b
+```
+
+Your active model is stored in:
+
+```
+~/.vibecode/config.json
+```
+
+---
+
+## 💬 Starting an AI Coding Session
+
+From any project directory:
+
+```bash
+vibecode
+```
+
+You will see:
+
+```
+Vibecode Agent using model: qwen2.5-coder:7b
+vibecode>
+```
+
+Now you can give natural language coding instructions.
+
+Example:
+
+```
+vibecode> create a ruby method called greet that prints hello world
+```
+
+---
+
+## 🧠 How Vibecode Works
+
+The AI responds using structured instructions that Vibecode turns into real actions.
+
+### AI Can Request to Read Files
+
+Vibecode will load the file and send contents back to the AI.
+
+### AI Can Propose File Changes
+
+You will see a **diff preview** before any file is modified.
+
+You must approve changes before they are applied.
+
+### AI Can Suggest Git Commands
+
+Examples:
+
+* `git status`
+* `git checkout -b feature/login`
+* `git add .`
+* `git commit -m "Add login feature"`
+* `git push origin feature/login`
+
+You must approve each command before it runs.
+
+---
+
+## 🔒 Safety Model
+
+Vibecode is **human-in-the-loop by default**.
+
+| Action               | Requires Approval |
+| -------------------- | ----------------- |
+| Reading files        | ❌                 |
+| Editing files        | ✅                 |
+| Running Git commands | ✅                 |
+| Pushing to remote    | ✅                 |
+
+Vibecode **cannot access files outside your current directory**.
+
+---
+
+## 🗂 Project Awareness
+
+Each time you prompt Vibecode, it automatically sends the AI:
+
+* Your project file tree
+* Relevant file contents (when needed)
+* Conversation history
+
+This allows the AI to reason about your codebase like a real assistant.
+
+---
+
+## 🛠 Internal Architecture (For Contributors)
+
+| Component      | Responsibility                           |
+| -------------- | ---------------------------------------- |
+| `CLI`          | Handles commands and interactive session |
+| `OllamaClient` | Talks to Ollama HTTP API                 |
+| `Agent`        | AI reasoning loop + instruction parsing  |
+| `Workspace`    | Safe file reading/writing with diffs     |
+| `Git`          | Safe Git command execution               |
+
+---
+
+## 🧪 Example Workflow
+
+1. Start Vibecode in your repo
+2. Ask for a feature
+3. Vibecode proposes edits
+4. You approve
+5. Vibecode runs Git commands
+6. You review and push
+
+---
+
+## 🧭 Roadmap Ideas
+
+* Streaming model responses
+* Auto-approve mode
+* Test runner integration
+* Linter auto-fix mode
+* Pull request description generator
+
+---
+
+## ❤️ Philosophy
+
+Vibecode keeps your code and AI **local, private, and developer-controlled**.
+
+No cloud. No tracking. Just you and your AI pair programmer in the terminal.
+
+---
+
+## 📄 License
+
+MIT License
+

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+task default: :test

data/bin/console

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "vibecode"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/exe/vibecode

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+require "vibecode/cli"
+Vibecode::CLI.start(ARGV)
+