What is Beads-Kanban GEMINI.md?

Project instructions for an AI coding assistant working on Beads Kanban, a VS Code extension for managing issues on a visual Kanban board. The project stores tasks, bugs, and features in local SQLite database files and requires a defined workflow for selecting and recording work.

Use them when onboarding to the repository, finding ready tasks, updating Beads issues, or running the project safely on Windows.

They explain the repository's task-tracking rules and the correct Windows commands, helping work stay in the project's central issue system.

How davidcforbes/Beads-Kanban configures Gemini CLI

Reuse

Borrowing it

Nothing to install: this file belongs to davidcforbes/Beads-Kanban. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/davidcforbes/Beads-Kanban/main/GEMINI.md

Clone the repo

git clone --depth 1 https://github.com/davidcforbes/Beads-Kanban

Made for: Gemini CLI.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/davidcforbes/beads-kanban/gemini-md/github.svg)](https://agentmods.dev/instructions/davidcforbes/beads-kanban/gemini-md)

Your own site

<a href="https://agentmods.dev/instructions/davidcforbes/beads-kanban/gemini-md"><img src="https://agentmods.dev/badge/instructions/davidcforbes/beads-kanban/gemini-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/davidcforbes/beads-kanban/gemini-md"><img src="https://agentmods.dev/badge/instructions/davidcforbes/beads-kanban/gemini-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 845 This file is loaded in full into every session.

When invoked 845 The same file — it is already loaded in full.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00845	$0.00845
Opus 5	$0.00423	$0.00423
Sonnet 5	$0.00169	$0.00169
Haiku 4.5	$0.00085	$0.00085

Measured 4d ago against content hash 2f0b54e2a4f7, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

Beads-Kanban GEMINI.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

GEMINI.md · 73 lines

How it starts

The opening of the file, as written. The whole thing — 73 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Beads Kanban - Gemini Context

Project Overview

Beads Kanban is a VS Code extension that provides a visual Kanban board and table view for managing Beads issues directly within the editor. It interacts with local .beads/*.db SQLite files to track tasks, bugs, and features.

⚠️ Critical System Instructions (Windows)

Shell: Always use pwsh.exe for PowerShell commands.
Shell Tool Warning: The standard run_shell_command tool is BROKEN on Windows (missing node-pty).
- NEVER use run_shell_command.
- ALWAYS use Desktop Commander MCP tools:
  - DC: execute_command (or start_process / read_process_output for long-running tasks).
  - DC: list_directory.
MCP Configuration: To enable/disable MCP servers, edit C:\Users\david\.gemini\settings.json (mcp.excluded list).

Beads Agent Workflow (MANDATORY)

This repository uses Beads (bd) as the primary issue tracker and long-term memory.

Core Rules

Source of Truth: The .beads/ directory is the canonical store of work. Do not use Markdown TODO lists.
Onboarding: If you haven't, run bd onboard (or check if it's done).
Task Selection: Use bd ready --json to find unblocked work.
Status Updates:
- Start: bd update <id> --status in_progress
- Finish: bd close <id> --reason "..."
Dependencies: Use bd dep add to link issues (blocks/blocked-by).

Session End: You MUST sync and push before stopping.

git pull --rebase
bd sync
git push
# Verify "up to date with origin"

Development Environment

Setup

npm install

Build & Run

Compile: npm run compile
Watch Mode: npm run watch (run in background for auto-compilation)
Run Extension: Press F5 in VS Code (launch "Extension").

Testing

Run All Tests: npm test
Unit/Integration: npm run test:adapter
Validation: npm run test:validation
Performance Benchmarks: node --expose-gc scripts/benchmark-loading.js test-databases/test-db-10k.db

Read the full file on GitHub · 73 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

4d ago First seen · 73 lines · 845 tokens per session scan A 2f0b54e2a4f7

Subscribe to this mod's changes

Beads-Kanban GEMINI.md is an instructions file published in the GitHub repository davidcforbes/Beads-Kanban (14 stars, last pushed 4mo ago), licensed MIT. It adds 845 tokens to every session, about $0.0042 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-04.

Project management

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,153 tokens

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

Beads-Kanban: Instructions file for Gemini CLI