@bloxystudios/bloxycode 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Bloxy Studios
+
+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.

package/README.md

@@ -0,0 +1,256 @@
+# BloxyCode
+
+[![Vibeathon 2026](https://img.shields.io/badge/Vibeathon-Feb%202026-blue?style=for-the-badge)](https://www.bridgemind.ai/vibeathon)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](LICENSE)
+[![Bun](https://img.shields.io/badge/Bun-1.3+-black?style=for-the-badge)](https://bun.sh/)
+
+> **Vibeathon Entry**: This project is a submission for the [BridgeMind Vibeathon](https://www.bridgemind.ai/vibeathon) (Feb 1-14, 2026)
+>
+> **BloxyCode** is an enhanced fork of [OpenCode](https://github.com/opencode-ai/opencode) featuring **Bloxy** - an autonomous task execution system that runs until your tasks are done.
+
+An AI-powered coding CLI tool that brings the power of Claude and other LLMs directly to your terminal. BloxyCode enables autonomous code generation, intelligent file operations, and seamless AI-assisted development workflows.
+
+## Features
+
+### 🤖 Autonomous Task Execution (Bloxy Mode)
+BloxyCode's flagship feature - execute complex coding tasks autonomously from Product Requirements Documents (PRDs):
+- **Sequential Task Processing**: Parse PRD markdown files and execute tasks one by one
+- **Automatic Testing**: Run tests after each task (when configured)
+- **Auto-commit**: Optional automatic git commits with descriptive messages
+- **Retry Logic**: Configurable retry attempts for failed tasks
+- **Task State Management**: Track pending, in-progress, completed, and failed tasks
+
+### 🛠️ Comprehensive Tool Set
+- **File Operations**: Read, write, edit files with intelligent context awareness
+- **Code Search**: Fast glob patterns and grep-based content search with ripgrep
+- **Bash Integration**: Execute shell commands with proper error handling
+- **Web Capabilities**: Web search and content fetching
+- **Task Management**: Built-in todo list tracking for complex workflows
+
+### 🎯 Multi-Agent System
+Create and manage specialized AI agents for different tasks:
+- **Primary Agents**: Main agents for direct interaction
+- **Subagents**: Specialized agents for delegated tasks
+- **Custom Tools**: Configure which tools each agent can access
+- **Agent Generation**: LLM-powered agent creation from descriptions
+
+### 🔌 Extensibility
+- **Model Provider Support**: Anthropic, OpenAI, Google, Azure, AWS Bedrock, and 15+ other providers
+- **MCP (Model Context Protocol)**: Standard protocol for AI-tool integration
+- **Custom Commands**: Define project-specific slash commands
+- **Skill System**: Reusable best practices and workflows
+
+### 🚀 Antigravity Integration (Built-in)
+Access Claude and Gemini models through your Google account — no API keys required:
+- **Claude Opus 4.5 & Sonnet 4.5** with extended thinking support
+- **Gemini 3 Pro/Flash** with configurable thinking levels
+- **Multi-account support** with automatic rate limit rotation
+- **Free tier access** using your Google Cloud quota
+- See [Antigravity Documentation](docs/ANTIGRAVITY.md) for setup
+
+### 💬 Multiple Interaction Modes
+- **CLI Chat**: Direct command-line interaction with AI
+- **Server Mode**: Run as a persistent server with HTTP API
+- **TUI (Terminal UI)**: Rich terminal interface built with SolidJS
+- **Session Management**: Continue conversations, attach to running servers
+
+### 🔐 Smart Permissions
+- **Permission System**: Fine-grained control over tool usage
+- **Pattern Matching**: Allow/deny based on file patterns
+- **Interactive Prompts**: Ask for permission when needed
+
+## Installation
+
+```bash
+# Install via npm (coming soon)
+npm install -g @bloxystudios/bloxycode
+
+# Or run directly with bun
+bun install
+bun run dev
+```
+
+## Basic Usage
+
+### Start a conversation
+
+```bash
+# Simple prompt
+bloxycode run "create a new React component"
+
+# Continue previous session
+bloxycode run -c "add tests for the component"
+
+# Use specific model
+bloxycode run -m anthropic/claude-sonnet-4 "refactor the authentication logic"
+
+# Attach files to context
+bloxycode run -f src/app.ts "review this code for bugs"
+```
+
+### Run in Bloxy autonomous mode
+
+Create a `PRD.md` file:
+
+```markdown
+# My Feature PRD
+
+## Tasks
+- [ ] Create user authentication module
+- [ ] Add login and signup endpoints
+- [ ] Write unit tests for auth module
+```
+
+Then execute:
+
+```bash
+bloxycode run "/bloxy PRD.md"
+```
+
+BloxyCode will autonomously:
+1. Read and parse the PRD
+2. Execute each task sequentially
+3. Run tests (if configured)
+4. Commit changes (if auto-commit enabled)
+5. Report progress and results
+
+### Agent Management
+
+```bash
+# Create a new custom agent
+bloxycode agent create
+
+# List available agents
+bloxycode agent list
+
+# Use a specific agent
+bloxycode run --agent code-reviewer "review my changes"
+```
+
+### Server Mode
+
+```bash
+# Start server on specific port
+bloxycode serve --port 4096
+
+# Attach to running server
+bloxycode run --attach http://localhost:4096 "your prompt"
+```
+
+## Configuration
+
+BloxyCode can be configured via:
+- `~/.config/bloxycode/config.yml` (global)
+- `.bloxycode/config.yml` (project-specific)
+
+Example configuration:
+
+```yaml
+# Default model
+model: anthropic/claude-sonnet-4
+
+# Share sessions automatically
+share: auto
+
+# Custom agents directory
+agents: .bloxycode/agent
+
+# Bloxy mode settings
+bloxy:
+  autoCommit: true
+  testCommand: "bun test"
+  lintCommand: "bun run typecheck"
+  maxRetries: 3
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `run [message]` | Start or continue a conversation |
+| `serve` | Start the BloxyCode server |
+| `agent create` | Create a new custom agent |
+| `agent list` | List all available agents |
+| `auth` | Authenticate with providers |
+| `models` | List available models |
+| `export` | Export session history |
+| `import` | Import session history |
+| `stats` | View usage statistics |
+
+## Tools Available to AI
+
+BloxyCode provides these tools to AI agents:
+
+- **bash**: Execute shell commands
+- **read**: Read file contents
+- **write**: Create/overwrite files
+- **edit**: Make precise edits to files
+- **glob**: Find files by pattern
+- **grep**: Search file contents
+- **webfetch**: Fetch web content
+- **task**: Delegate to subagents
+- **todowrite/todoread**: Manage task lists
+- **bloxy_control**: Control autonomous execution (Bloxy mode)
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Run in development mode
+bun run dev
+
+# Type check
+bun run typecheck
+
+# Run tests
+bun test
+
+# Run specific test
+bun test test/tool/tool.test.ts
+
+# Build
+bun run build
+```
+
+## Project Structure
+
+```
+src/
+├── cli/          # CLI commands and interface
+├── tool/         # AI tool implementations
+├── session/      # Session management
+├── agent/        # Agent system
+├── bloxy/        # Autonomous mode implementation
+├── provider/     # LLM provider integrations
+├── server/       # HTTP server
+└── util/         # Utilities
+```
+
+## Architecture
+
+BloxyCode uses a modern TypeScript architecture:
+- **Runtime**: Bun with TypeScript ESM modules
+- **Validation**: Zod schemas for all inputs
+- **State**: Namespace-based organization
+- **UI**: SolidJS + OpenTUI for terminal interfaces
+- **Communication**: MCP (Model Context Protocol) compatible
+
+## Contributing
+
+Contributions are welcome! Please see our contributing guidelines for more details.
+
+## License
+
+MIT
+
+## Links
+
+- [Documentation](https://docs.bloxycode.dev) (coming soon)
+- [GitHub](https://github.com/bloxystudios/bloxycode)
+- [Discord Community](https://discord.gg/bloxycode) (coming soon)
+
+---
+
+Built with ❤️ by Bloxy Studios

package/bin/bloxycode

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+
+const childProcess = require("child_process")
+const fs = require("fs")
+const path = require("path")
+const os = require("os")
+
+function run(target) {
+  const result = childProcess.spawnSync(target, process.argv.slice(2), {
+    stdio: "inherit",
+  })
+  if (result.error) {
+    console.error(result.error.message)
+    process.exit(1)
+  }
+  const code = typeof result.status === "number" ? result.status : 0
+  process.exit(code)
+}
+
+const envPath = process.env.BLOXYCODE_BIN_PATH
+if (envPath) {
+  run(envPath)
+}
+
+const scriptPath = fs.realpathSync(__filename)
+const scriptDir = path.dirname(scriptPath)
+
+const platformMap = {
+  darwin: "darwin",
+  linux: "linux",
+  win32: "windows",
+}
+const archMap = {
+  x64: "x64",
+  arm64: "arm64",
+  arm: "arm",
+}
+
+let platform = platformMap[os.platform()]
+if (!platform) {
+  platform = os.platform()
+}
+let arch = archMap[os.arch()]
+if (!arch) {
+  arch = os.arch()
+}
+const base = "bloxycode-" + platform + "-" + arch
+const binary = platform === "windows" ? "bloxycode.exe" : "bloxycode"
+
+function findBinary(startDir) {
+  let current = startDir
+  for (;;) {
+    const modules = path.join(current, "node_modules")
+    if (fs.existsSync(modules)) {
+      const entries = fs.readdirSync(modules)
+      for (const entry of entries) {
+        if (!entry.startsWith(base)) {
+          continue
+        }
+        const candidate = path.join(modules, entry, "bin", binary)
+        if (fs.existsSync(candidate)) {
+          return candidate
+        }
+      }
+    }
+    const parent = path.dirname(current)
+    if (parent === current) {
+      return
+    }
+    current = parent
+  }
+}
+
+const resolved = findBinary(scriptDir)
+if (!resolved) {
+  console.error(
+    'It seems that your package manager failed to install the right version of the bloxycode CLI for your platform. You can try manually installing the "' +
+      base +
+      '" package',
+  )
+  process.exit(1)
+}
+
+run(resolved)

package/package.json

@@ -0,0 +1,133 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "version": "1.0.0",
+  "name": "@bloxystudios/bloxycode",
+  "type": "module",
+  "license": "MIT",
+  "author": "Bloxy Studios <contact@bloxystudios.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bloxystudios/bloxycode.git"
+  },
+  "homepage": "https://github.com/bloxystudios/bloxycode#readme",
+  "bugs": {
+    "url": "https://github.com/bloxystudios/bloxycode/issues"
+  },
+  "scripts": {
+    "typecheck": "tsgo --noEmit",
+    "test": "bun test",
+    "build": "bun run script/build.ts",
+    "dev": "bun run --conditions=browser ./src/index.ts",
+    "random": "echo 'Random script updated at $(date)' && echo 'Change queued successfully' && echo 'Another change made' && echo 'Yet another change' && echo 'One more change' && echo 'Final change' && echo 'Another final change' && echo 'Yet another final change'",
+    "clean": "echo 'Cleaning up...' && rm -rf node_modules dist",
+    "lint": "echo 'Running lint checks...' && bun test --coverage",
+    "format": "echo 'Formatting code...' && bun run --prettier --write src/**/*.ts",
+    "docs": "echo 'Generating documentation...' && find src -name '*.ts' -exec echo 'Processing: {}' \\;",
+    "deploy": "echo 'Deploying application...' && bun run build && echo 'Deployment completed successfully'"
+  },
+  "bin": {
+    "bloxycode": "./bin/bloxycode"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    "./*": "./src/*.ts"
+  },
+  "devDependencies": {
+    "@babel/core": "7.28.4",
+    "@octokit/webhooks-types": "7.6.1",
+    "@parcel/watcher-darwin-arm64": "2.5.1",
+    "@parcel/watcher-darwin-x64": "2.5.1",
+    "@parcel/watcher-linux-arm64-glibc": "2.5.1",
+    "@parcel/watcher-linux-arm64-musl": "2.5.1",
+    "@parcel/watcher-linux-x64-glibc": "2.5.1",
+    "@parcel/watcher-linux-x64-musl": "2.5.1",
+    "@parcel/watcher-win32-x64": "2.5.1",
+    "@tsconfig/bun": "^1.0.10",
+    "@types/babel__core": "7.20.5",
+    "@types/bun": "^1.3.8",
+    "@types/turndown": "5.0.5",
+    "@types/yargs": "17.0.33",
+    "@typescript/native-preview": "^7.0.0-dev.20260130.1",
+    "typescript": "^5.9.3",
+    "vscode-languageserver-types": "3.17.5",
+    "why-is-node-running": "3.2.2"
+  },
+  "dependencies": {
+    "@actions/core": "1.11.1",
+    "@actions/github": "6.0.1",
+    "@agentclientprotocol/sdk": "0.12.0",
+    "@ai-sdk/amazon-bedrock": "3.0.73",
+    "@ai-sdk/anthropic": "2.0.57",
+    "@ai-sdk/azure": "2.0.91",
+    "@ai-sdk/cerebras": "1.0.34",
+    "@ai-sdk/cohere": "2.0.22",
+    "@ai-sdk/deepinfra": "1.0.31",
+    "@ai-sdk/gateway": "2.0.25",
+    "@ai-sdk/google": "2.0.52",
+    "@ai-sdk/google-vertex": "3.0.97",
+    "@ai-sdk/groq": "2.0.34",
+    "@ai-sdk/mistral": "2.0.27",
+    "@ai-sdk/openai": "2.0.89",
+    "@ai-sdk/openai-compatible": "1.0.30",
+    "@ai-sdk/perplexity": "2.0.23",
+    "@ai-sdk/provider": "2.0.1",
+    "@ai-sdk/provider-utils": "3.0.20",
+    "@ai-sdk/togetherai": "1.0.31",
+    "@ai-sdk/vercel": "1.0.31",
+    "@ai-sdk/xai": "2.0.51",
+    "@clack/prompts": "1.0.0-alpha.1",
+    "@gitlab/gitlab-ai-provider": "3.3.1",
+    "@hono/standard-validator": "0.1.5",
+    "@hono/zod-validator": "^0.7.6",
+    "@modelcontextprotocol/sdk": "1.25.2",
+    "@octokit/graphql": "9.0.2",
+    "@octokit/rest": "^22.0.1",
+    "@openauthjs/openauth": "^0.4.3",
+    "@opencode-ai/plugin": "^1.1.44",
+    "@opencode-ai/sdk": "^1.1.44",
+    "@openrouter/ai-sdk-provider": "1.5.2",
+    "@opentui/core": "0.1.75",
+    "@opentui/solid": "0.1.75",
+    "@parcel/watcher": "2.5.1",
+    "@pierre/diffs": "^1.0.9",
+    "@solid-primitives/event-bus": "1.1.2",
+    "@solid-primitives/scheduled": "1.5.2",
+    "@standard-schema/spec": "1.0.0",
+    "@zip.js/zip.js": "2.7.62",
+    "ai": "5.0.119",
+    "bonjour-service": "1.3.0",
+    "bun-pty": "0.4.4",
+    "chokidar": "4.0.3",
+    "clipboardy": "4.0.0",
+    "decimal.js": "10.5.0",
+    "diff": "8.0.2",
+    "fuzzysort": "3.1.0",
+    "gray-matter": "4.0.3",
+    "hono": "4.10.7",
+    "hono-openapi": "1.1.2",
+    "ignore": "7.0.5",
+    "jsonc-parser": "3.3.1",
+    "minimatch": "10.0.3",
+    "open": "10.1.2",
+    "opentui-spinner": "0.0.6",
+    "partial-json": "0.1.7",
+    "quansync": "^1.0.0",
+    "remeda": "2.26.0",
+    "solid-js": "1.9.10",
+    "strip-ansi": "7.1.2",
+    "tree-sitter-bash": "0.25.0",
+    "turndown": "7.2.0",
+    "ulid": "3.0.1",
+    "vscode-jsonrpc": "8.2.1",
+    "web-tree-sitter": "0.25.10",
+    "xdg-basedir": "5.1.0",
+    "yargs": "18.0.0",
+    "zod": "4.1.8",
+    "zod-to-json-schema": "3.24.5"
+  }
+}

package/src/acp/README.md

@@ -0,0 +1,164 @@
+# ACP (Agent Client Protocol) Implementation
+
+This directory contains a clean, protocol-compliant implementation of the [Agent Client Protocol](https://agentclientprotocol.com/) for opencode.
+
+## Architecture
+
+The implementation follows a clean separation of concerns:
+
+### Core Components
+
+- **`agent.ts`** - Implements the `Agent` interface from `@agentclientprotocol/sdk`
+  - Handles initialization and capability negotiation
+  - Manages session lifecycle (`session/new`, `session/load`)
+  - Processes prompts and returns responses
+  - Properly implements ACP protocol v1
+
+- **`client.ts`** - Implements the `Client` interface for client-side capabilities
+  - File operations (`readTextFile`, `writeTextFile`)
+  - Permission requests (auto-approves for now)
+  - Terminal support (stub implementation)
+
+- **`session.ts`** - Session state management
+  - Creates and tracks ACP sessions
+  - Maps ACP sessions to internal opencode sessions
+  - Maintains working directory context
+  - Handles MCP server configurations
+
+- **`server.ts`** - ACP server startup and lifecycle
+  - Sets up JSON-RPC over stdio using the official library
+  - Manages graceful shutdown on SIGTERM/SIGINT
+  - Provides Instance context for the agent
+
+- **`types.ts`** - Type definitions for internal use
+
+## Usage
+
+### Command Line
+
+```bash
+# Start the ACP server in the current directory
+opencode acp
+
+# Start in a specific directory
+opencode acp --cwd /path/to/project
+```
+
+### Programmatic
+
+```typescript
+import { ACPServer } from "./acp/server"
+
+await ACPServer.start()
+```
+
+### Integration with Zed
+
+Add to your Zed configuration (`~/.config/zed/settings.json`):
+
+```json
+{
+  "agent_servers": {
+    "OpenCode": {
+      "command": "opencode",
+      "args": ["acp"]
+    }
+  }
+}
+```
+
+## Protocol Compliance
+
+This implementation follows the ACP specification v1:
+
+✅ **Initialization**
+
+- Proper `initialize` request/response with protocol version negotiation
+- Capability advertisement (`agentCapabilities`)
+- Authentication support (stub)
+
+✅ **Session Management**
+
+- `session/new` - Create new conversation sessions
+- `session/load` - Resume existing sessions (basic support)
+- Working directory context (`cwd`)
+- MCP server configuration support
+
+✅ **Prompting**
+
+- `session/prompt` - Process user messages
+- Content block handling (text, resources)
+- Response with stop reasons
+
+✅ **Client Capabilities**
+
+- File read/write operations
+- Permission requests
+- Terminal support (stub for future)
+
+## Current Limitations
+
+### Not Yet Implemented
+
+1. **Streaming Responses** - Currently returns complete responses instead of streaming via `session/update` notifications
+2. **Tool Call Reporting** - Doesn't report tool execution progress
+3. **Session Modes** - No mode switching support yet
+4. **Authentication** - No actual auth implementation
+5. **Terminal Support** - Placeholder only
+6. **Session Persistence** - `session/load` doesn't restore actual conversation history
+
+### Future Enhancements
+
+- **Real-time Streaming**: Implement `session/update` notifications for progressive responses
+- **Tool Call Visibility**: Report tool executions as they happen
+- **Session Persistence**: Save and restore full conversation history
+- **Mode Support**: Implement different operational modes (ask, code, etc.)
+- **Enhanced Permissions**: More sophisticated permission handling
+- **Terminal Integration**: Full terminal support via opencode's bash tool
+
+## Testing
+
+```bash
+# Run ACP tests
+bun test test/acp.test.ts
+
+# Test manually with stdio
+echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":1}}' | opencode acp
+```
+
+## Design Decisions
+
+### Why the Official Library?
+
+We use `@agentclientprotocol/sdk` instead of implementing JSON-RPC ourselves because:
+
+- Ensures protocol compliance
+- Handles edge cases and future protocol versions
+- Reduces maintenance burden
+- Works with other ACP clients automatically
+
+### Clean Architecture
+
+Each component has a single responsibility:
+
+- **Agent** = Protocol interface
+- **Client** = Client-side operations
+- **Session** = State management
+- **Server** = Lifecycle and I/O
+
+This makes the codebase maintainable and testable.
+
+### Mapping to OpenCode
+
+ACP sessions map cleanly to opencode's internal session model:
+
+- ACP `session/new` → creates internal Session
+- ACP `session/prompt` → uses SessionPrompt.prompt()
+- Working directory context preserved per-session
+- Tool execution uses existing ToolRegistry
+
+## References
+
+- [ACP Specification](https://agentclientprotocol.com/)
+- [TypeScript Library](https://github.com/agentclientprotocol/typescript-sdk)
+- [Protocol Examples](https://github.com/agentclientprotocol/typescript-sdk/tree/main/src/examples)