LemonBeam

LemonBeam shines a fresh beam of light on an unfamiliar codebase.

LemonBeam is a source-backed onboarding guide generator for public GitHub repositories. It helps developers understand a JavaScript or TypeScript project by scanning the repository, selecting relevant evidence, and generating a contributor-oriented guide with citations back to the source.

Instead of asking an LLM to reason over an entire repository at once, LemonBeam breaks the repo into meaningful pieces, ranks useful evidence, keeps the prompt within a token budget, and returns a structured guide that new contributors can inspect and verify.

Paste a public GitHub repository URL, enter your OpenRouter API key, and generate a source-backed onboarding guide.

LemonBeam generating a source-backed onboarding guide with inline repository citations.

Watch the LemonBeam demo video

LemonBeam produces a fixed-format onboarding guide with sections for:

• Project Overview
• Setup / Installation
• Running Locally
• Project Structure
• Testing
• Uncertainties and Missing Information

Each guide is generated from repository evidence selected for the scan. When LemonBeam cannot confidently analyze something, it reports that uncertainty instead of silently pretending the information was available.

LemonBeam is built for:

• developers joining an unfamiliar codebase
• open-source contributors deciding where to start
• maintainers who want a quick contributor-facing guide

Developer onboarding information is often scattered across README files, package scripts, configuration files, source folders, and test suites.

General-purpose AI tools can often produce readable repository summaries, but readable is not always reliable. LemonBeam focuses on making repository guides more:

• grounded — generated from selected repository evidence
• inspectable — connected to source citations
• consistent — returned in a predictable guide format
• bounded — designed to stay within token limits instead of dumping an entire repo into a model
• honest — skipped or excluded evidence is surfaced in the guide

1. Open the deployed LemonBeam app.
2. Paste a public GitHub repository URL.
3. Enter your OpenRouter API key.
4. Generate the guide.
5. Review the Markdown guide and use the citations to inspect the source files behind the claims.

LemonBeam currently supports public JavaScript and TypeScript GitHub repositories. Private repositories, monorepos, and non-GitHub providers are outside the current launch scope.

LemonBeam uses a bring-your-own-key flow. OpenRouter API keys are sent only for the active scan request and are not stored by the frontend.

• Web app: public GitHub repositories only

• Web app: JavaScript and TypeScript repositories only

• Web app: private repositories are not currently supported

• Web app: monorepos are not currently supported

• Large repositories may have some evidence excluded through token budgeting

• Node.js

• npm

• An OpenRouter API key for guide generation

• A GitHub personal access token is recommended for repository validation rate limits

git clone <repository-url>
cd lemonbeam

npm install

cd frontend
npm install

cd ../backend
npm install

Create a local backend environment file:

cp backend/.env.example backend/.env

Then update backend/.env as needed:

OPENROUTER_API_KEY=your-openrouter-api-key-here
GITHUB_TOKEN=your-github-token-here
PORT=3000

For the web app, LemonBeam uses a bring-your-own-key flow: the OpenRouter key is normally entered in the UI for each scan and is not stored by the frontend.

From the project root:

npm run dev

This starts the frontend and backend development servers together.

You can also run them separately:

npm run dev:frontend
npm run dev:backend

From the project root:

npm test

For watch mode:

npm run test:watch

Frontend linting:

npm run lint

Backend type checking:

cd backend
npm run typecheck

• React

• TypeScript

• Vite

• Tailwind CSS

• Node.js

• Express

• TypeScript

• GitHub API

• OpenRouter API

• Tree-sitter

• tiktoken

• SQLite schema placeholders for future evidence storage

The primary launch experience is the web app, but the repository also includes local interfaces for experimentation.

LemonBeam can also be run locally as a CLI to scan a project directory and generate an onboarding guide.

The simplest way to run the CLI is to pass your OpenRouter key directly with the --key flag when you run the command.

You can also create a .env file in the directory where you plan to run the CLI if you do not want to pass the key every time:

OPENROUTER_API_KEY=your-openrouter-api-key-here
git clone https://github.com/oslabs-beta/lemonbeam.git
cd lemonbeam
npm install
npm run build
npm link

From the root of the project you want to scan:

lemonbeam --key your-openrouter-api-key-here

If you configured OPENROUTER_API_KEY in .env, you can run:

npx lemonbeam

By default, the CLI scans the current directory. You can also pass a local project path or supported GitHub repository URL.

After the scan finishes, the CLI asks whether to save the generated guide as a Markdown file or print a preview in the terminal.

LemonBeam can also run as a local MCP server, allowing Claude Desktop, Claude Code, or another MCP-compatible client to call LemonBeam as a tool.

git clone https://github.com/oslabs-beta/lemonbeam.git
cd lemonbeam
npm install
npm run build

Create an OpenRouter key at openrouter.ai/keys.

Add this to your MCP client config, replacing the path and key with your local values:

{
  "mcpServers": {
    "lemonbeam": {
      "command": "node",
      "args": ["/absolute/path/to/lemonbeam/dist/mcp/index.js"],
      "env": {
        "OPENROUTER_API_KEY": "your-key-here"
      }
    }
  }
}

Optional: to raise the GitHub rate limit, add "GITHUB_TOKEN": "your_github_personal_access_token" to env. Only add it with a real token — a placeholder value makes every scan fail.

Config locations:

• Claude Desktop: Settings → Developer → Edit Config
• Claude Code:.mcp.json in your project root

After saving the config, fully restart your MCP client. The generate_onboarding_guide tool will then be available.

Ask your assistant:

Generate an onboarding guide for https://github.com/owner/repo

See the in-app MCP setup guide for the walkthrough and troubleshooting notes.

• PROJECT_BRIEF.md — product goals, MVP scope, guide format, user flow, and evaluation plan
• ARCHITECTURE.md — system architecture and backend design
• API_CONTRACT.md — frontend/backend API specification
• DATABASE.md — SQLite schema notes and lifecycle
• TESTING.md — testing strategy
• DECISIONS.md — architectural decisions and rationale
• CONTRIBUTING.md — contributor workflow
• AGENTS.md — instructions for AI coding agents

We welcome contributions to LemonBeam.

Fork the repository. 2. Create a feature branch:

git checkout -b feature/your-feature-name

Make your changes and add or update tests when behavior changes. 4. Commit your work:

git commit -m "Add your feature description"

Push your branch:

git push origin feature/your-feature-name

Open a pull request with a clear summary and testing notes.

The LemonBeam team will review your pull request and provide feedback.

• Stronger citation validation
• Better uncertainty summaries
• Better error reporting
• Larger repository support
• Broader language support
• Private repository support

LemonBeam is open source under the MIT License.

source & further reading

github.com — original article Show HN: Live Quantum Circuits Visualizator for Reinforcement Learning OpenCode-search: fast full-text search of all your sessions Valen: A multimodal decision model inspired by Jev