Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.blocks.team/llms.txt

Use this file to discover all available pages before exploring further.

v1.2.15

REST API

  • REST API Release - Blocks now includes a REST API for creating sessions, polling replies, and sending follow-ups from your own apps. Start with the REST API Quick Start, then create a session with a request like:
curl -X POST https://api.blocks.team/rest/v1/sessions \
  -H "Authorization: ApiKey $BLOCKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent_name":"claude","message":"Summarize the latest PR activity."}'

Sessions & UI

  • Improved Linear Session Naming - Linear-linked sessions now get clearer, more consistent names
  • Linear Session Grouping - Linear sessions now form session groups automatically when they share the same resource
  • Creator Avatars - Sessions now show creator avatars so it is easier to see ownership at a glance
  • Automation Run Visibility - Automation runs are now shown directly on their respective automation pages in Dashboard > Settings
  • Auto-Archive Dialog Caching - Improved caching for the auto-archive dialog so dismissing it prevents it from reappearing for 30 minutes

Pull Requests & Integrations

  • Bitbucket PR Diff Fetching - Fixed an issue preventing Bitbucket pull request diffs from fetching
  • Duplicate Bitbucket PR Links - Fixed an issue where Bitbucket sessions could sometimes render duplicate pull request links

Agents & Models

  • Codex 5.5 Support - Codex 5.5 is now available with both Codex and OpenCode agents
  • Kimi 2.6 in OpenCode - Kimi 2.6 is now available on OpenCode

Stability & Reliability

  • Improved Agent Dependency Isolation - Reduced hanging-session edge cases by improving dependency isolation between agents

v1.2.14

Optimizations

  • Faster Chat Starts - Optimized chat startup speed for a snappier session launch experience
  • Edge-Routed Requests - Improved global performance by routing requests through edge locations
  • REST API Rate Limits - Updated REST API rate limits to 100 requests per minute

Agents

  • Sisyphus Plugin Version Pinning - Fixed issues with Sisyphus by pinning plugin versions more reliably
  • Reliable PR Registration - Improved pull request registration stability for long-running sessions
  • Kimi 2.6 Compatibility - Fixed Kimi Code issues when using Kimi 2.6
  • Kimi Code Error Handling - Improved error handling for Kimi Code
  • Kimi Code Restart Fixes - Fixed agent restart issues in Kimi Code
  • Claude Code 1M Context Support - Added support for Claude Code models with a 1 million token context window
  • Opus 4.7 on Bedrock - Fixed Opus 4.7 support for Claude Code on Bedrock
  • Sub-Agent Visibility - Claude Code now surfaces more SubAgent activity

v1.2.13

Custom MCP Servers

  • Improved MCP Settings - Added rename support, clearer required environment variable actions, and a more polished loading and save flow

Sessions & Models

  • Shared Session Filters - Session filters now stay in sync between the main panel and sessions table
  • Profile-Based Model Sync - Session model selection now follows the latest profile-based model changes more reliably

Pull Requests & UI

  • Improved PR Performance - Large pull request diffs render more smoothly with better chunking and tab behavior
  • UI Polish - Improved page titles and Vercel preview link handling

v1.2.12

Sessions & Navigation

  • Improved Navigation Performance - Page loads across the app are now faster

Pull Requests & UI

  • Improved PR Panel - Added inline diff rendering with better handling for large files and multi-PR sessions
  • UI Polish - Fixed mobile layout issues and improved markdown wrapping in chat

v1.2.11

Platform & Workspace

  • Updated Atlassian OAuth Scopes - Refined Atlassian OAuth permissions to support the latest integration requirements
  • Workspace-Level Git Configuration - Workspace admins can now configure a fallback git commit email for unmapped sessions or users without a personal git email configured
  • Disable Private Sessions - Added a workspace admin setting that disables private sessions
  • Hide the Game - Added a workspace user setting to hide the game

Sessions & Integrations

  • Rename Sessions - Sessions can now be renamed
  • Enhanced Linear Attachments Support - Improved handling for Linear attachments

Agents & Models

  • Model Selection Across Blocks - You can now choose the model used for sessions, automations, and PR review runs, and sessions now support switching models mid-session
Model selection across sessions, automations, and PR review
  • Opus 4.7 Support - Added support for Opus 4.7
  • Codex 5.4 Support - Added support for Codex 5.4
  • Gemini Support in OpenCode - OpenCode now supports Gemini
  • Kimi 2.6 in Kimi Code - Added support for Kimi 2.6 in Kimi Code
  • Safe Image Read Tool for Claude Code - Added a safe image read tool for Claude Code that prevalidates images and rejects problematic reads that could otherwise corrupt a session due to an open Claude Code issue

Stability & Reliability

  • Claude Code Refresh Tokens - Improved refresh token stability with Claude Code
  • Gemini CLI Stability - Improved Gemini CLI agent stability
  • OpenCode Error Handling - Improved error handling for OpenCode

v1.2.10

PR & Integrations

  • PR Panel - View file diffs, commits, checks, comments, statuses, and Vercel previews without leaving Blocks
  • GitLab Merge Request Support - Enables GitLab PR review and automations
  • Installer Actor Mentions (GitLab/Bitbucket) - The user who authorizes the Blocks integration can now be directly mentioned instead of @blocks; as mentioned previously, creating a dedicated integration user for GitLab and Bitbucket is still recommended
  • Workspace-Specific Linear Accounts - Connected Accounts now lets you link a different Linear account for each workspace
  • Clearer Integration Selection - Updated guidance on when user integrations are used across the Anthropic/OpenAI integration pages and Claude Code/Codex agent pages

v1.2.9

Docs

  • Attachment Support - You can now upload attachments directly to Blocks sessions
  • OpenCode Onboarding (Kimi Key) - Support for KIMI_API_KEY with OpenCode during onboarding
  • Installation Profiles - Create a model/MCP configuration with a custom slash command (for example, @blocks /claude-fast mapped to Claude Code with Haiku)

v1.2.8

Custom MCP Servers

  • JSON Configuration - Define MCP servers directly in the Blocks dashboard using a JSON object specifying the command, arguments, and environment variables
  • Environment Variable Injection - Reference global environment variables in your MCP config using ${env:VARIABLE_NAME} — Blocks resolves these at runtime so secrets are never hardcoded
  • Workspace-Wide - MCP servers are available across your entire workspace and can be enabled or disabled per agent
  • Variable Helper - A dropdown in the MCP server editor lists your global environment variables and copies the correct template string for you

Bug Fixes

  • Improved user integration usage to stabilize Anthropic and OpenAI user integrations

v1.2.7

Git Configuration

  • Commit Author Email - Set a custom email address to use as the commit author across your Blocks sessions from Dashboard → Settings → Git
  • Per-User Setting - This is a personal configuration and does not affect other workspace members
  • Vercel Build Previews - Setting your commit email to an address in your GitHub, GitLab, or Bitbucket organization enables Vercel to create build previews for PRs opened by Blocks

GitHub Bot Invocations

  • New Setting - Enable bot user invocations from Dashboard → Settings → GitHub, allowing GitHub bot users to mention Blocks and create sessions
  • Disabled by Default - Bot invocations are off by default and must be explicitly enabled per workspace

Bug Fixes

  • Fixed an issue where Linear agent sessions were not being mapped to the correct workspace user

v1.2.6

Automations

  • Event-Driven Agent Runs - Trigger coding agents automatically on GitHub PRs, GitLab MRs, Bitbucket PRs and pushes, GitHub Actions failures, and scheduled intervals — no manual mention required
  • Custom Prompts - Write a prompt per automation that the agent receives whenever the trigger fires
  • Repository Scoping - Scope automations to specific repositories or run across all connected repos
  • CI Check Display - Show automation results as a native CI check on pull requests, blocking merges until the automation passes
  • Workspace or Private Visibility - Share automations across your workspace or keep them private

PR Review

  • Automatic PR Reviews - Run a coding agent on every pull request across your connected repositories without any manual mention
  • Per-Repo Control - Enable or disable reviews for individual repositories from a single settings page
  • Custom Review Instructions - Add a .blocks/review.md file to a repository to customize what the agent looks for in that repo’s PRs
  • Agent Selection - Choose any configured agent for reviews
  • Supported Platforms - Works with GitHub, GitLab, and Bitbucket

Global Configuration

  • Global Configuration Repository - Set any connected repository as your workspace’s global configuration repo from Settings → Global Configuration
  • Automatic Loading - Every Blocks session will automatically load Skills, Hooks, and Sub-Agents from the configured repository at runtime

v1.2.5

Session Groups

  • Linked Sessions - Sessions that share a common resource (such as a Linear issue, GitHub PR, or Slack thread) are now automatically grouped together
  • View Related Sessions - Open the session properties panel on any session page to see other sessions in the same group
  • Filter by Resource - Adjust the sessions list filters to group by resource, giving you a consolidated view of all activity around a specific issue, PR, or thread

v1.2.4

Organization Workspaces

  • Self-Serve Creation - Create an organization workspace anytime from the workspace switcher in the bottom-left of the dashboard — no onboarding required
  • Role-Based Access - Invite team members as Admins or Members, with admins controlling what members can see and do
  • Admin Controls - Restrict member visibility into API keys, environment variables, integrations, analytics, and more from Settings → Permissions
  • Workspace Isolation - Repositories, skills, sessions, and settings are fully isolated between workspaces

UI Revamp

  • Refreshed Dashboard - Updated visual design across the dashboard for a cleaner, more consistent experience
  • Workspace Switcher - New workspace switcher in the bottom-left sidebar for faster context switching

v1.2.3

Kimi Code Agent

  • Moonshot AI Integration - Kimi Code is now available in Blocks, powered by Moonshot AI’s Kimi models
  • API Key Configuration - Connect your Kimi API key from the Blocks dashboard under Agents → Kimi Code
  • Invoke via Slash Command - Use /kimi to run Kimi Code on any request, or set it as your default agent
  • Experimental Status - Available now as an experimental agent

v1.2.2

Cursor CLI Agent

  • Premium Models - Access Composer, GPT-5.2-codex, Claude 4.5 (Sonnet/Opus), and Gemini 3 Pro through a single subscription
  • Subscription Model - Requires Cursor Pro or Team subscription with API key
  • Invoke via Slash Command - Use /cursor to invoke (cannot be set as default agent)

Support for PR Skills & Hooks

  • Agent PR Creation Skills - Define custom agent skills for pull request creation with personalized templates and workflows
  • PR Hooks Support - Configure hooks to customize pull request templates and defaults
  • Draft Mode Control - Set default draft mode and other PR settings through custom skills or hooks
.claude/skills/SKILL.md
---
name: create-pr
description: Generate and open a pull request using the repository PR template and GitHub CLI. Use when asked to create a PR, open a pull request, or submit changes for review.
---

# Open Pull Request

Generate a pull request that conforms to organization standards.

...

v1.2.1

Sisyphus Agent

  • Multi-Agent Orchestration - Introducing Sisyphus (Oh My OpenCode), a sophisticated orchestration system that coordinates multiple specialized agents
  • Specialized Agent Team - Main Conductor (Claude Opus 4.5), Oracle (GPT-5), and Backend Specialist (Claude Sonnet 4.5) work together on complex tasks
  • Complex Workflows - Ideal for full-stack feature implementation, large-scale refactoring, and multi-file changes requiring domain expertise
  • Claude Code Compatibility - Built with compatibility layer for seamless integration
  • API Key Configuration - Supports both Anthropic and OpenAI API keys for full capabilities
  • Experimental Status - Available now as an experimental agent via /sisyphus slash command

v1.2.0

OpenCode

  • You can now use OpenCode in Blocks!
  • OpenAI and Anthropic API Key Support - Configure OpenCode with your OpenAI or Anthropic API keys

Database Integration

  • Postgres Support - Connect a Postgres database to your Blocks workspace
  • Bastion Connection - Secure database connections through SSH bastion hosts with support for private keys and credentials

Linear Integration

  • Default Assign Mode - Configure the default mode (Edit or Plan) when assigning Linear tickets to agents, streamlining your workflow

Infrastructure

  • GitHub Token Refresh - Improved GitHub token refresh mechanism in agent sandboxes for more reliable authentication

v1.1.0

Plan Mode

Now you can create a plan before implementation happens:
  • Mode Switching - Toggle between Plan and Edit mode when creating a new session from the dashboard, Slack, GitHub, and Linear
  • Plan Visualization - See your implementation plan displayed clearly in the session
  • Make Changes - Work with the agent to update the plan
  • One-Click Implementation - Implement planned changes with a single button
  • Use Anywhere - Run plan mode from the Dashboard, GitHub, Slack, and Linear

Post-Clone Scripts

  • Add a .blocks/post-clone or .blocks/post-clone.sh with one or more shell commands directly in your repository:
#!/bin/bash
npm run i

Claude Code Hook and Skills Support

  • Read directly from .claude folders in cloned repositories

Enhanced File Viewer

  • Inline File Viewing - View files directly in chat conversations
  • Full-Screen Mode - Dedicated full-screen viewer for focused file review

Enhanced TODOs

  • Collapsible TODO List - View all in-progress TODOs directly above your message box in a session
  • Reduce Clutter - TODO updates no longer clutter your main chat history

AWS Integration

  • Credential Configuration - Set up AWS access keys and secrets from the settings page
  • OIDC Support Coming Soon
  • Bedrock API Keys - Claude Code can now be configured to use an AWS Bedrock API key

Linear Integration

  • Default Team Configuration - Set a default Linear team for new issue creation, overwrite by specifying a specific team

Other Improvements

  • Session Details - View creation dates for all your sessions in the sidebar
  • Unarchive Sessions - Restore archived sessions when needed
  • GitHub Branches - Quick access to branches from the GitHub menu in message box command menus
  • Preserved Redirects - Return to your intended page after signing in when visiting an unauthenticated link
  • Improved User Management - Filtered non-human users from the Linear claim user dialog