BSE_Code 1.3.0

BSE-Code

An AI coding assistant CLI powered by OpenRouter. Understands natural language, reads and writes files, runs shell commands, supports MCP servers, skills, project memory, themes, and session management — right from your terminal.

Prerequisites

• .NET 10 SDK
• An OpenRouter API key (free tier available)

Install

1. Clone

git clone <repo-url>
cd <repo-folder>

2. Pack

dotnet pack BSE_Code.csproj -c Release -o ./nupkg

3. Install as a global tool

dotnet tool install --global --add-source ./nupkg BSE_Code

To update after a code change — bump <Version> in the csproj, repack, then:

dotnet tool update --global --add-source ./nupkg BSE_Code

First-run Setup

On first run, an interactive wizard will:

1. Ask for your OpenRouter API key — get one free at https://openrouter.ai/keys
2. Fetch the live model list from OpenRouter, grouped by Free / Paid
3. Let you pick a model by number
4. Save everything to ~/.bse-code/config.json

Re-run the wizard any time:

bse-code --config

Config location:

• Windows: %USERPROFILE%\.bse-code\config.json
• Linux/macOS: ~/.bse-code/config.json

Usage

Interactive REPL (recommended)

bse-code

  ╭──────────────────────────────────────────╮
  │   ██████╗ ███████╗███████╗               │
  │   ██╔══██╗██╔════╝██╔════╝               │
  │   ██████╔╝███████╗█████╗   ─ code        │
  │   ██╔══██╗╚════██║██╔══╝                 │
  │   ██████╔╝███████║███████╗               │
  │   ╚═════╝ ╚══════╝╚══════╝               │
  ╰──────────────────────────────────────────╯
  model  : google/gemini-2.5-pro-exp-03-25:free
  theme  : default
  cwd    : my-project
  skills : 2 loaded
  mcp    : 5 tools from 1 server(s)
  memory : 1 BSE.md file(s) loaded
  type /help for commands · /exit to quit

 my-project (main) ❯ 

One-shot mode

bse-code -p "<prompt>"
bse-code -p "<prompt>" --output-format json

All flags

bse-code                              # Interactive REPL
bse-code -p "<prompt>"                # One-shot prompt
bse-code --model <model-id>           # Override model for this session
bse-code --theme <name>               # Set color theme for this session
bse-code --output-format json|text    # Output format (one-shot only)
bse-code --config                     # Re-run the setup wizard
bse-code --version, -v                # Show version
bse-code --help, -h                   # Show help

REPL Slash Commands

Core

Appearance

Built-in themes: default, dracula, monokai, ocean, forest, light

Skills

MCP

Memory (BSE.md)

Sessions

Special Input Prefixes

@ — File/directory injection (like Gemini CLI)

@src/Program.cs explain this file
@src/ summarize all source files

Injects file or directory contents directly into your prompt.

! — Shell passthrough (like Gemini CLI)

!git status
!dotnet build
!ls -la

Runs a shell command directly without involving the AI.

Skills

Skills are markdown files that provide reusable instructions or workflows.

Locations:

• ~/.bse-code/skills/ — user-level (available in all projects)
• .bse-code/skills/ — project-level

Example skill (.bse-code/skills/review.md):

# Code Review Skill

Review the provided code for:
- Correctness and logic errors
- Performance issues
- Security vulnerabilities
- Code style and readability

Provide specific, actionable feedback.

Invoke with /review or pass a file: /review @src/MyClass.cs

Project Memory (BSE.md)

BSE.md files are loaded automatically and injected into the system prompt — similar to Claude's CLAUDE.md and Gemini's GEMINI.md.

Hierarchy (all merged):

1. ~/.bse-code/BSE.md — global user preferences
2. ./BSE.md — project-specific context
3. ./BSE.local.md — local overrides (add to .gitignore)

Create one:

bse-code
/init

Example BSE.md:

# My Project

## Tech Stack
- .NET 10, C#, ASP.NET Core

## Coding Standards
- Use record types for DTOs
- Prefer async/await throughout
- Write XML docs for public APIs

## Development Commands
dotnet run
dotnet test

MCP (Model Context Protocol)

Connect external tools and services via MCP servers.

Config file: ~/.bse-code/mcp.json

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"],
      "disabled": false
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token"
      }
    }
  }
}

MCP tools are automatically available to the AI with the naming convention mcp__serverName__toolName.

Available AI Tools

Themes

Switch theme:

/theme dracula

Or for a single session:

bse-code --theme monokai

Configuration

Config file: ~/.bse-code/config.json

{
  "api_key": "sk-...",
  "model": "google/gemini-2.5-pro-exp-03-25:free",
  "base_url": "https://openrouter.ai/api/v1",
  "theme": "default"
}

Environment variables (always override config file)

PowerShell (persist):

[System.Environment]::SetEnvironmentVariable('OPENROUTER_API_KEY', 'your-key', 'User')
[System.Environment]::SetEnvironmentVariable('OPENROUTER_MODEL', 'deepseek/deepseek-r1:free', 'User')

Bash (persist):

export OPENROUTER_API_KEY="your-key"
export OPENROUTER_MODEL="deepseek/deepseek-r1:free"

File Structure

~/.bse-code/
├── config.json          # Main config (API key, model, theme)
├── mcp.json             # MCP server definitions
├── BSE.md               # Global memory (injected into every session)
└── skills/
    └── *.md             # User-level skills

.bse-code/               # Project-level (in your repo)
├── BSE.md               # Project memory
└── skills/
    └── *.md             # Project-level skills

./BSE.md                 # Project memory (root level)
./BSE.local.md           # Local overrides (gitignore this)

Dependencies

License

MIT