Bioscode

AI-powered coding assistant CLI.

Installation

npm install -g bioscode

Requirements: Bun runtime

Usage

# Interactive mode
bioscode

# With initial message
bioscode "explain this codebase"

# Continue last session
bioscode -c

# Use specific model
bioscode -m anthropic/claude-sonnet-4-20250514

# Start HTTP server for VS Code extension
bioscode --port 50123

Commands

bioscode              Start interactive TUI
bioscode auth         Manage API credentials
bioscode config       Show configuration

Options

VS Code Extension Communication

When started with --port, Bioscode runs an HTTP server for communication with the VS Code extension.

Architecture: HTTP + SSE

• HTTP REST API: For requests (prompts, sessions, auth, permissions)
• SSE (Server-Sent Events): For real-time streaming responses

API Endpoints

SSE Events

The /events endpoint streams the following event types:

Example: Connecting to SSE

const eventSource = new EventSource('http://localhost:50123/events');

eventSource.addEventListener('message.delta', (e) => {
  const data = JSON.parse(e.data);
  console.log('Content:', data.content);
});

eventSource.addEventListener('tool.start', (e) => {
  const data = JSON.parse(e.data);
  console.log('Tool:', data.toolName);
});

Publishing

PorterCode uses a unified publish workflow that handles both GitHub Releases (standalone executables) and npm publishing.

Prerequisites

1. GitHub CLI: gh installed and authenticated (gh auth login)
2. npm account: With publish access and 2FA enabled
3. Bun: Runtime installed

Quick Publish (Recommended)

# Publish everywhere (GitHub Releases + npm)
bun run publish --version 0.1.11

# Preview without publishing
bun run publish --version 0.1.11 --dry-run

Publish Options

What Gets Published

GitHub Releases (--github)

Standalone executables uploaded to bioscode-releases:

Plus install scripts: install-windows.bat, install.sh

npm Registry (--npm)

Obfuscated JavaScript package:

• dist/index.js - Compiled and obfuscated code
• dist/**/*.d.ts - Type declarations
• LICENSE, NOTICE, package.json

Source code (src/) is NOT published to npm.

Publish Workflow Steps

The unified publish command performs these steps:

1. [1/4] Update version - Updates package.json with the new version
2. [2/4] Build executables - Compiles standalone binaries for all platforms (GitHub only)
3. [3/4] GitHub Release - Creates release and uploads executables
4. [4/4] npm Publish - Runs npm login (for OTP) then publishes

Manual Publishing (Advanced)

If you need more control, use individual scripts:

# Build standalone executables only
bun run build-all-platforms.ts

# Upload to GitHub Releases only
bun run release.ts
bun run release.ts --draft  # Create as draft

# Build npm package only
bun run build

Verify Published Package

# Check npm
npm info bioscode

# Test installation
npm install -g bioscode
bioscode --version

# Check GitHub release
gh release view v0.1.11 --repo Lupy-AI/bioscode-releases

Rollback (if needed)

# npm: Unpublish within 72 hours
npm unpublish bioscode@0.1.11

# npm: Deprecate (after 72 hours)
npm deprecate bioscode@0.1.11 "Critical bug, use 0.1.12"

# GitHub: Delete release
gh release delete v0.1.11 --repo Lupy-AI/bioscode-releases --yes

Features

• 🤖 Multi-LLM Support: Works with Anthropic Claude, OpenAI GPT, Google Gemini, and Groq
• 🔐 Granular Permissions: Fine-grained control over file operations and command execution
• 💬 Interactive Sessions: Save and resume conversations
• ⚙️ Configurable: Hierarchical configuration system with JSONC support
• 🔧 Extensible Tools: Read, write, edit files, execute commands, search code
• 🎨 Terminal UI: Beautiful interactive interface built with Ink
• 📡 VS Code Integration: HTTP + SSE server for VS Code extension

Development

# Run in dev mode
bun run dev

# Run tests
bun test

# Type check
bun run typecheck

Configuration

Create a bioscode.jsonc file in your project root or ~/.config/bioscode/bioscode.jsonc globally:

{
  "model": "claude-sonnet-4",
  "permission": {
    "edit": "ask",      // Always ask before editing files
    "bash": "auto"      // Execute commands automatically
  }
}

Configuration Options

License

Proprietary - See LICENSE for details.

Copyright (c) 2025 Carlos Alexis Gomez Ruiz. All rights reserved.