BSE_Code 1.2.0

BSE-Code

An AI coding assistant CLI powered by OpenRouter. Understands natural language, reads and writes files, and runs shell commands — 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)

Just run with no arguments to start a persistent multi-turn session:

bse-code

You'll get a prompt with your current folder and a conversation that keeps context across messages:

  ╭─────────────────────────────────────╮
  │         BSE-Code  ·  AI Coding      │
  ╰─────────────────────────────────────╯
  model  : google/gemini-2.5-pro-exp-03-25:free
  cwd    : my-project

  my-project ❯ explain what this repo does

One-shot mode

Run a single prompt and exit:

bse-code -p "<prompt>"

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 --config               # Re-run the setup wizard
bse-code --version, -v          # Show version
bse-code --help, -h             # Show help

REPL Slash Commands

Inside the interactive session:

Examples

# Interactive session
bse-code

# One-shot prompts
bse-code -p "Explain what this codebase does"
bse-code -p "Read src/Program.cs and summarize it"
bse-code -p "Create a hello world C# file at hello.cs"
bse-code -p "List all .cs files in the project"

# Use a specific model just for this run
bse-code --model deepseek/deepseek-r1:free -p "Refactor this function"

Available AI Tools

The model can invoke these tools on your machine:

Tool calls are shown inline with the file/command being used and a ✓/✗ result indicator.

Configuration

Environment variables always override the saved 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"

Dependencies

License

MIT