Bleenk logo

Experimental

Bleenk CLI is still experimental. APIs, flags, and behavior may change without notice.

bleenk-cli · v1.0.0

$ bleenk

The Bleenk coding agent in your terminal. Repo-aware, tool-using, and CI-ready with programmatic mode.

# Python 3.12+. uv recommended. PyPI package: bleenk-cli.

bleenk-cli

PyPI · Python 3.12+

Experimentalv1.0.0
installuv tool install bleenk-cli
authcd my-repo && bleenk
cibleenk -p "…" --agent auto-approve --trust

uv · pip · bash installer · macOS · Linux · Windows

# features

Built for your repo and CI

Interactive TUI locally, headless -p mode in pipelines. MCP, agents, and session resume.

$ cd my-repo && bleenk
Agent ready · default mode
/mode plan

agents

Agents in your terminal

Same Bleenk models and agents interactively, or with -p for scripts and CI.

git status · AGENTS.md
tree + context loaded
repo-aware tools on

repo

Repo-aware by default

Reads your tree, git status, and AGENTS.md for project context.

$ bleenk -p "Review PR" --agent auto-approve --trust
--output text
CI run complete

ci

Programmatic mode for CI

Run headless with --agent auto-approve and BLEENK_API_KEY in GitHub Actions.

$ /mcp
/marketplace
connectors installed

mcp

MCP and marketplace

Connect MCP servers via config or /marketplace. Browse tools with /mcp.

# usage

bleenk --help

Interactive TUI plus programmatic flags. Slash commands like /mcp run inside the session.

bleenk --help
stdout
$bleenk
Start the interactive coding agent in your repo (TUI).
Run bleenk --help for all flags.
commands · click to preview

# ci

GitHub Actions example

Install with uv, set BLEENK_API_KEY, and run programmatic mode on every pull request.

BLEENK_API_KEY

GitHub Actions

CI programmatic mode

Add BLEENK_API_KEY to repo secrets. Use --trust and --agent auto-approve in headless runs.

.github/workflows/bleenk-review.yml
name: Bleenk CLI review
on:
  pull_request:
    branches: [main]
jobs:
  agent-review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@v4
      - uses: astral-sh/setup-uv@v7
        with:
          enable-cache: true
      - uses: actions/setup-python@v5
        with:
          python-version: "3.12"
      - run: uv tool install bleenk-cli
      - name: Run agent
        env:
          BLEENK_API_KEY: ${{ secrets.BLEENK_API_KEY }}
        run: |
          bleenk --trust --workdir . --agent auto-approve \
            --max-turns 15 --output text \
            -p "Review this PR for bugs and missing tests."

# faq

Common questions

Install, auth, CI secrets, and what the CLI does and does not do.

bleenk faq
CLI documentationGitHubPyPI