Skip to content
CAI
Software that uses CAICheck a score

clacky-ai/openclacky

31.7

Weak · 6 November 2026

78.5k

lines of production code

Ruby

with JavaScript

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add DingTalk channel support via Stream Mode WebSocket

Users can now connect their DingTalk bots to Clacky. This change introduces a new adapter that establishes a persistent WebSocket connection (Stream Mode) to receive inbound messages and replies. It supports sending rich text (Markdown) and native file/image attachments via DingTalk's OAPI, handles group chat @-mentions, and validates credentials during setup.

lib/clacky/server/channel/adapters/dingtalk · high confidence

Add Discord channel adapter with REST and Gateway support

Users can now connect Clacky to Discord. The new adapter authenticates via a bot token, receives messages in real-time through the Discord Gateway WebSocket, and sends text and file attachments via the REST API. It supports both direct messages and group chats (with mention-based filtering), handles message updates, and includes a connection test feature in the configuration UI.

lib/clacky/server/channel/adapters/discord · high confidence

Add Homebrew formula and installation documentation for OpenClacky

Users can now install the OpenClacky CLI tool via Homebrew using the provided formula (openclacky.rb) and follow the instructions in the new README.md to tap the repository and install the package. The formula is configured to depend on Ruby 3.3 and installs both the 'openclacky' and 'clacky' wrapper scripts, with a placeholder SHA256 hash that requires manual update upon gem publication.

homebrew · high confidence

Add MCP server support with OAuth authentication and CLI management

Users can now connect to remote Model Context Protocol (MCP) servers via HTTP transport, including full OAuth 2.0 authorization (login, status, logout) for protected endpoints. A new CLI interface (cli\_commands.rb) exposes capabilities, login, status, and logout commands to manage server connections, while the connection manager and OAuth modules handle credential storage, token refresh, and session management. The client and registry components support both stdio and streamable-http transports, enabling subagents to discover and invoke tools on configured MCP servers through the local Clacky HTTP API.

lib/clacky/mcp · high confidence

Add Meeting Assistant panel with recording, transcription, and wake-word activation

Introduces a new Meeting Assistant panel (view.js) that allows users to record audio, view live captions via speech-to-text, and interact with the Clacky agent. The panel supports wake-word activation (e.g., "Hey Clacky" or "小克小克") to trigger questions during meetings, includes controls for muting and interrupting responses, and provides a vocabulary feature for custom proper nouns. It also handles session state, including resuming recordings after page refreshes, and displays meeting minutes upon completion.

_lib/clacky/default\extensions/meeting/panels · high confidence

Add QQ Official Bot channel adapter with QR-code onboarding

Users can now connect the Clacky server to the QQ Official Bot platform. This change introduces the QQ adapter (lib/clacky/server/channel/adapters/qq), which handles WebSocket gateway connections, message sending/receiving for C2C and group chats, and attachment uploads. It also includes a QR-code-based binding flow (QrBinder) that lets users link their bot credentials by scanning a Tencent-hosted QR code, removing the need to manually copy App IDs and secrets.

lib/clacky/server/channel/adapters/qq · high confidence

Add WeCom (Enterprise WeChat) channel adapter with image and file support

Users can now connect their WeCom bot to receive and send messages, including text, images, and files. The adapter handles incoming messages via a WebSocket long-connection, automatically downloading and decrypting images and files (including mixed message types) from WeCom's servers. It also supports sending text replies and uploading/sending local files (images and documents) back to chats through the WeCom API.

lib/clacky/server/channel/adapters/wecom · high confidence

Added CodeMirror editor library to vendor directory

The CodeMirror JavaScript library (codemirror.min.js) has been added to the project's vendor directory. This provides the underlying engine for syntax highlighting and code editing capabilities in the web interface, supporting features such as syntax highlighting for various programming languages and per-block copy buttons for code blocks.

lib/clacky/web/vendor · high confidence

Added sample project fixtures for benchmarking

Added new Ruby source files to the benchmark fixtures sample project, including an API handler for routing user and order requests, an order calculator for computing totals with tax and discounts, and a user renderer for generating HTML profiles and lists.

_benchmark/fixtures/sample\project · high confidence

Billing dashboard now supports currency conversion and model filtering

The billing feature has been restructured into a dedicated store and view module, introducing support for currency conversion (USD to CNY) with configurable exchange rates stored in localStorage, and the ability to filter usage data by specific models via a custom dropdown selector. The dashboard now displays total cost in the selected currency, includes a cost estimation disclaimer, and provides a print-receipt share button with an SVG icon, while maintaining existing functionality for viewing usage stats, cache hit rates, and request counts.

lib/clacky/web/features/billing · high confidence

Initial English and Chinese localization for error messages and UI progress

The application now supports English and Chinese for user-facing text, specifically covering LLM error messages (such as quota exhaustion, rate limits, and invalid keys), platform license/device errors, and channel progress indicators (like thinking, working, and tool usage states). This change introduces the \lib/clacky/locales\ module with \en.rb\ and \zh.rb\ translation files and an \i18n.rb\ loader that defaults to English but detects Chinese via environment variables, ensuring users see localized feedback for API issues and system status updates.

lib/clacky/locales · high confidence

Introduce Advisor extension for post-task next-step recommendations

Adds the Advisor extension, which analyzes the recent tool trail and conversation context after each task round to generate up to three distinct next-step options (e.g., continue, verify, or wrap up). The extension hooks into the agent lifecycle via \after\_tool\_use\ and \on\_complete\ events, runs the LLM analysis asynchronously to avoid blocking the main thread, and displays the results in a UI card above the input box. Users can click an option to fill the composer, use a one-click send button, dismiss the card for the current round, or permanently toggle the feature on/off via a settings switch. The extension is configured via \\~/.clacky/advisor.yml\ and includes its own i18n strings.

_lib/clacky/default\extensions/advisor/panels · high confidence

Introduce Creator Center for managing extensions and skills

Adds a new Creator Center workspace (mounted from the sidebar) that consolidates extension and skill management into two tabs. The Extensions tab provides a local extension picker, verification/debugging, and a publish flow supporting both marketplace and brand distribution, including version validation, README editing, and screenshot uploads. The Skills tab lists cloud and local skills with options to publish or iterate. The UI includes segmented tabs, skeleton loading states, and localized strings for all user-facing interactions.

_lib/clacky/default\extensions/ext-studio/panels · high confidence

Introduce Extension Studio API for managing local extensions

A new backend API handler is added to the ext-studio extension, providing endpoints to list local extensions, verify their integrity, pack them into zip files, and publish them to the marketplace or a brand library. This enables users to debug, package, and distribute their local extension containers directly through the studio interface, including support for device binding checks and brand-specific publishing flows.

_lib/clacky/default\extensions/ext-studio/api · high confidence

Introduce Feishu channel adapter with rich media and card support

Users can now connect the system to Feishu (Lark) to send and receive messages, including text, images, files, and rich post content. The adapter supports interactive CardKit features such as progress tracking cards and question cards with clickable buttons. It also handles Feishu document links within messages and manages authentication, including automatic token refresh and retry logic for revoked credentials.

lib/clacky/server/channel/adapters/feishu · high confidence

Introduce UI2 component library for terminal interface

This change introduces a new UI2 component architecture in lib/clacky/ui2/components, replacing the previous rendering logic with a modular set of classes. The new system includes BaseComponent for shared formatting (text wrapping, truncation, theming), CommandSuggestions for interactive slash-command dropdowns, InputArea and InlineInput for enhanced multi-line input with paste handling and session bar info, MessageComponent for rendering user/assistant messages with file attachments, ModalComponent for configuration forms and menus, TodoArea for task tracking, ToolComponent for displaying tool calls and results, and WelcomeBanner for startup branding and agent info. This refactoring provides a more structured, theme-aware, and interactive terminal user experience.

lib/clacky/ui2/components · high confidence

Users can now connect a WeChat bot via the new Weixin channel adapter. The implementation includes an HTTP API client for long-polling messages and sending text or files, along with a background send queue that batches, throttles, and retries outgoing messages to handle rate limits and ensure delivery.

lib/clacky/server/channel/adapters/weixin · high confidence

Introduce base adapter interface and registry for IM channels

Users can now extend the system with new instant messaging platforms through a standardized adapter pattern. A new base class defines the contract for platform-specific implementations (such as Feishu or WeCom), including methods for sending messages, updating progress, and handling configuration. A registry mechanism allows these adapters to register themselves by platform ID, enabling the channel system to dynamically discover and route messages to the correct backend service.

lib/clacky/server/channel/adapters · high confidence

Introduce modern web UI with theme system, i18n, and white-label branding

The web interface has been modernized with a new design system supporting light, dark, and dim themes, along with a customizable accent color. A new router manages navigation across sessions, tasks, skills, and settings. The UI now includes full internationalization (i18n) with runtime language switching and a white-label branding system that allows for custom logos, names, and activation via license keys. Additional features include a new onboarding flow, project management, session recycling (trash), and improved workspace file handling.

lib/clacky/web · high confidence

Introduce new session landing page with agent selection and advanced options

The new-session feature now provides a dedicated landing page for starting sessions, allowing users to browse and select from a list of available agents (filtering out hidden ones) and configure advanced options such as session name, model, working directory, and project association. The view persists the last-used agent and project in localStorage to restore previous context on return, and supports quick session creation from the sidebar using default settings. The store manages agent loading, selection state, and session creation API calls, while the view renders agent cards with avatars, badges (NEW, EXT, Custom), and localized titles/descriptions.

lib/clacky/web/features/new-session · high confidence

Introduce new tooling and interaction capabilities

This release adds several new tools to the agent's toolkit: \ask\_user\ for structured, option-based user feedback; \invoke\_skill\ to trigger specialized skills via subagents or inline injection; and \browser\ for real Chromium automation via the Chrome DevTools MCP server. It also introduces a \security\ module that pre-validates shell commands to block dangerous operations (like \eval\ or writes to system directories) and rewrites risky patterns (like \curl \| bash\) for manual review. Existing tools have been enhanced: \edit\ now performs literal string replacement while preserving original line-ending styles (CRLF vs LF) and provides helpful context on match failures; \file\_reader\ delegates parsing to a dedicated processor to support images, PDFs, and documents with OCR fallback; \grep\ and \glob\ now auto-expand bare patterns to recursive searches and respect \.gitignore\ with configurable limits; and \base\ provides a unified path expansion helper that handles WSL path translation and \\~\ expansion.

lib/clacky/tools · high confidence

Introduce session trash with project filtering and auto-cleanup hints

The trash panel now supports managing deleted sessions alongside files. Users can filter the session list by source (cron vs. manual) and by specific project, with a custom dropdown for project selection. The interface includes a hint regarding session auto-cleanup and displays orphan status for files. The view also features skeleton loading states during data fetches and uses custom select components for filters.

lib/clacky/web/features/trash · high confidence

Introduce skill-creator with automated evaluation and self-evolution capabilities

The skill-creator default skill is now available to create, modify, and optimize skills through an interactive workflow or an automated 'Quick mode' for agent self-evolution. It includes a built-in evaluation system featuring a Blind Comparator, Post-hoc Analyzer, and Grader to objectively assess skill performance, along with an HTML-based review viewer for inspecting results. The skill also provides scripts to aggregate benchmark statistics and generate reports, enabling users to measure and improve skill accuracy and reliability.

_lib/clacky/default\skills/skill-creator · high confidence

Introduces Meeting extension, Tavily search provider, and Ruby 2.6+ compatibility

Users can now record and summarize meetings via the new Meeting extension (handling transcription, Q&A, and annotation) and perform web searches using the Tavily provider. The application also gains support for Ruby 2.6+ through added polyfills and UTF-8 encoding defaults, ensuring broader system compatibility.

lib · high confidence

Introduces UI2 terminal interface with CJK support and stacked progress indicators

Adds a new terminal UI implementation (UI2) that replaces the previous spinner-based progress model with a stackable, owned-progress system to prevent visual conflicts and duplicate output. The new interface features a split-screen layout with a scrollable output area and a fixed input/todo area, and includes a dedicated patch for the \strings\ library to correctly wrap ANSI-colored CJK text without raising IndexError. It also introduces theme detection for dark/light backgrounds, a new markdown renderer with theme-aware colors, and a \BlockFont\ alias for backward compatibility.

lib/clacky/ui2 · high confidence

Introduces server-mode authentication and encrypted skill support

The library now supports server-mode authentication via a persistent access key stored in \~/.clacky/access\_key (with CLACKY\_ACCESS\_KEY as a fallback), enabling key rotation without restarting the process. It also adds a pure-Ruby AES-256-GCM implementation to bypass LibreSSL bugs on older macOS Ruby versions, which is used to decrypt brand skills and enforce white-label licensing.

lib/clacky · high confidence

New 'Computer Use' extension for AI-driven desktop automation

A new 'Computer Use' extension has been added, allowing the AI to drive the desktop via screenshots, mouse, and keyboard. It supports macOS natively and Windows through WSL, and is disabled by default (enabled\_by\_default: false). The extension includes a CLI tool (bin/computer.rb) and skills for tasks like screenshots, clicking, typing, and zooming, with platform-specific backends (macOS.rb, windows.rb) and a PowerShell agent for Windows interop.

_lib/clacky/default\extensions/computer-use · high confidence

New CLI commands for creating, verifying, and publishing extensions

Users can now manage extension containers directly from the command line using the \clacky ext\ subcommand group. The new \clacky ext new\ command scaffolds runnable extension containers (including a full kitchen-sink template) into the local extensions directory. The \clacky ext verify\ and \clacky ext list\ commands allow users to validate extension configurations and inspect loaded units. Additionally, \clacky ext pack\ packages local extensions into distributable zip files, \clacky ext install\ installs them, and \clacky ext publish\/\unpublish\/\published\ manage the lifecycle of extensions on the OpenClacky marketplace, requiring device identity binding for publishing actions.

lib/clacky/extension · high confidence

New MCP server management panel with catalog and tool listing

A new read-only MCP panel has been added to the web UI, allowing users to view configured servers, toggle them on or off, and remove them. The panel displays server details (name, type, target) and includes a 'Probe' button to fetch and display the list of available tools for each server, with caching to avoid redundant API calls. Users can also request fixes or removals via a row menu, with errors displayed as toasts.

lib/clacky/web/features/mcp · high confidence

New Time Machine panel for session history and file restoration

A new Time Machine panel has been added to the session aside, providing a vertical timeline of tasks performed during the current session. Users can click on past tasks to expand inline cards showing affected files and actions, or switch to a two-pane detail view that mirrors the Git tab layout, displaying a file list alongside a unified diff. The panel supports restoring a previous state by rewriting files on disk, which triggers an inline confirmation dialog to prevent accidental data loss. It automatically updates via WebSocket events when tasks complete and fetches data from the session's time machine API endpoints.

_lib/clacky/default\_extensions/time\machine/panels · high confidence

New agent subsystems for long-running goals, cost tracking, and history navigation

The agent runtime now includes several new capabilities: a standing-goal loop (GoalManager/GoalState) that autonomously continues work toward a user-defined objective until a judge deems it done or the turn budget is exhausted; a cost tracking module (CostTracker) that records per-iteration spend, merges subagent costs into the parent session total, and persists billing records; a fake tool-call detector that retries when models emit text-formatted tool calls instead of structured ones; a hook manager for extension events (on\_start, before/after tool use, etc.); a history navigation module that indexes compressed chunk files and provides cursor-based pagination and previews; and a long-term memory updater that forks a subagent to persist high-value decisions after qualifying tasks. These changes enable autonomous goal completion, accurate billing, safer model interactions, extensibility, and efficient navigation of long, compressed conversation histories.

lib/clacky/agent · high confidence

New backup and restore interface in settings

Users can now manage backup settings directly from the web UI. This change introduces a new backup feature area that includes a store for managing backup status and configuration, and a view for rendering the settings. Key capabilities include toggling automatic backups, configuring whether sessions are included in backups, downloading backup archives, and restoring from a local archive file. The UI also provides feedback on the last backup run status and handles WebSocket reconnection events to refresh the restore status.

lib/clacky/web/features/backup · high confidence

New billing, extension, and concurrency subsystems

This release introduces a billing system that records token usage and costs per API call (lib/clacky/billing/billing\record.rb), a comprehensive extension framework supporting local/installed/builtin layers, API handlers, hooks, patches, and packager tools (lib/clacky/extension/\), and a fan-out concurrency engine for parallel subagent execution (lib/clacky/fanout.rb). It also adds a computer-use extension with screen capture and coordinate geometry logic (lib/clacky/default\_extensions/computer-use/lib/computer/geometry.rb).

openclacky · high confidence

New channel system for IM platform integration

The server now supports connecting to external Instant Messaging platforms (Feishu, WeCom, Weixin, Discord, DingTalk, Telegram) via a new channel subsystem. This introduces a configuration file (\~/.clacky/channels.yml) to manage platform credentials and global toggles for status messages, process narration, and progress cards. A ChannelManager supervises adapter threads, handling session binding, message routing, and interrupt arbitration, while ChannelUIControllers format agent output for IM constraints. The system also allows users to load custom adapters from \~/.clacky/channels/ or via extension containers, enabling extensibility to new IM platforms.

lib/clacky/server/channel · high confidence

New channel-manager skill for automated IM platform setup

Users can now configure and manage IM channels (Feishu, WeCom, Weixin, Discord, Telegram, DingTalk) directly through the agent. The new channel-manager skill provides a unified interface to set up, enable, disable, and diagnose channels. Setup flows are automated: Feishu and DingTalk use OAuth device flows (QR code scanning), Weixin uses iLink QR login, and Discord guides the user through the developer portal. The skill also includes tools to install and import Feishu-specific agent skills after channel configuration.

_lib/clacky/default\skills/channel-manager · high confidence

New default parsers for DOC, DOCX, PPTX, WPS, XLSX, and PDF with OCR/VLM fallbacks

The default parser suite now includes dedicated parsers for Microsoft Office and WPS formats, enabling direct text extraction without external conversion tools for many cases. DOC files are parsed using macOS textutil or Linux antiword; DOCX files are parsed natively in Ruby using rubyzip and REXML to extract text, headings, bold formatting, lists, and tables into Markdown. PPTX presentations are parsed slide-by-slide to extract titles, bullet points, and tables. WPS formats (.wps, .et, .dps) are handled via LibreOffice headless conversion. XLSX spreadsheets are parsed using Python's openpyxl in read-only streaming mode to efficiently convert sheets to Markdown tables. PDF handling has been expanded with a multi-tier strategy: it first attempts text extraction via pdftotext, falls back to pdfplumber for better layout preservation, and supports scanned pages through two OCR paths—standard Tesseract OCR (pdf\_parser\_ocr.py) and Vision Language Model transcription via the local server (pdf\_parser\_vlm.py)—allowing the agent to selectively OCR only the pages needed for the user's query.

_lib/clacky/default\parsers · high confidence

New extension marketplace with tabbed browsing and brand support

The extensions feature has been rebuilt with a new store and view architecture, introducing a tabbed interface that separates the public marketplace, installed extensions, and brand-specific catalogs. The view renders extension rows with localized display names, icons, and action buttons (install, enable, or manage), while the store manages state for pagination, sorting (defaulting to downloads), and search filtering. Brand-licensed installations receive a dedicated 'brand' tab that replaces the public marketplace, sourcing extensions from a private catalog endpoint.

lib/clacky/web/features/extensions · high confidence

New extension scaffolding with full and hello templates

The extension scaffold now provides two template profiles—\full\ and \hello\—to help developers quickly create extensions. The \full\ template generates a comprehensive reference extension that exercises all eight contribution types, including API handlers, multiple UI panel slots (sidebar, workspace, banner, aside, composer), custom skills, agent definitions, channel adapters, hooks, patches, and tools. The \hello\ template offers a simpler starting point with a basic API handler, a single aside panel, and an included test file. A new \TemplateRenderer\ utility handles the rendering of these ERB templates and the substitution of placeholders in both file contents and directory names.

lib/clacky/extension/scaffold · high confidence

New gem-release skill for automated openclacky gem releases

A new 'gem-release' skill has been added to automate the end-to-end release process for the openclacky Ruby gem. This skill introduces a release script that handles version bumping, running the test suite (including web search smoke tests), building the gem, publishing to RubyGems, creating GitHub Releases, and uploading artifacts to Tencent Cloud OSS CDN. It also includes agent instructions for manually writing CHANGELOG entries with proper external contributor attribution and generating user-facing release summaries.

.clacky/skills/gem-release · high confidence

New media-gen skill with image editing and video generation support

The media-gen skill has been introduced to allow users to generate and edit images, as well as create videos. The skill now supports image editing (modifying existing images via an \image\ input parameter) in addition to standard generation, and includes a new script (\video\_seq.sh\) to handle sequential video generation and stitching using the 'last-frame chaining' technique. Users can now produce longer videos by chaining multiple clips, with the skill handling the extraction of the last frame of one clip to serve as the input for the next, ensuring visual continuity.

_lib/clacky/default\skills/media-gen · high confidence

New modular shell script build system with region-aware installation

The installation scripts have been restructured into a template-based build system (scripts/build/) that generates standalone installers from .sh.cc source files. This introduces a modular library architecture (lib/colors.sh, lib/os.sh, lib/network.sh, etc.) with strict dependency checking for @include directives. The generated installers now feature robust network pre-flight checks that detect the user's region (China vs. Global) and automatically configure appropriate mirrors (Aliyun for China, global defaults otherwise) for apt, Homebrew, Ruby gems, Node.js, and mise. The system also includes improved WSL handling on Windows, with WSL1 preference and fallback to WSL2, along with better error handling and retry logic for package manager operations.

scripts · high confidence

New onboard scripts for importing external skills and installing built-in skills

The onboard process now includes two new Ruby scripts: \import\_external\_skills.rb\ scans for and imports skills from external tools like OpenClaw (supporting Windows-native paths on WSL) into isolated category directories, and \install\_builtin\_skills.rb\ fetches and installs built-in skills from the \/api/v1/skills/builtin\ endpoint.

_lib/clacky/default\skills/onboard/scripts · high confidence

New personal website skill for generating and publishing profile cards

Users can now generate a beautiful, mobile-first personal homepage (linktree-style) and publish it online for sharing. The skill reads user profile information from local agent files, creates a self-contained HTML file with zero external dependencies, and publishes it via a new API endpoint. It supports creating, updating, and deleting the published page, with automatic retry logic and HMAC-signed requests for reliability and security.

_lib/clacky/default\skills/personal-website · high confidence

New profile management store and view with safe memory editing

The profile feature now uses a dedicated store (store.js) to manage user/soul identity and memory data, handling network calls for loading, updating, and deleting memories, as well as initiating curate sessions. The view (view.js) renders these memories using a custom, safe Markdown renderer that escapes HTML to prevent injection, and provides a UI for managing memory cards with inline editing capabilities and confirmation dialogs for deletions.

lib/clacky/web/features/profile · high confidence

New script to scaffold Rails 7.x projects with Railway deployment support

A new shell script, create\_rails\_project.sh, has been added to the default skills to automate the creation of new Rails 7.x applications. The script clones a starter template, initializes a git repository, and runs the standard project setup. It also includes specific logic to add the x86\_64-linux platform to the Gemfile.lock, ensuring compatibility for deployments on Railway.

_lib/clacky/default\skills/new/scripts · high confidence

New server-side utilities and integrations

The server now includes several new capabilities: a BackupManager for creating and managing user backups with WSL support; a BrowserManager to control the Chrome DevTools MCP daemon lifecycle; a Channel system bridging sessions to IM platforms like Telegram, Feishu, and WeCom; a GitPanel for read-only git operations and safe commits; a DirPicker with WSL/Windows drive detection; a Discover module to find local server processes; and an EPIPESafeIO wrapper to prevent worker crashes from broken pipes.

lib/clacky/server · high confidence

New session aside chrome and unified extension registry

The web UI now features a dedicated session aside component that supports resizable panels, collapse/expand toggles, and a fullscreen mode, with width preferences persisted in the browser. This aside is driven by a new extension registry (Clacky.ext) that allows extensions to mount UI into specific slots, manage tabbed interfaces, and scope content to specific agents or sessions, while enforcing safety guarantees like crash containment and pure-mode isolation.

lib/clacky/web/core · high confidence

New shell-based installer, uninstaller, and dependency scripts

The build system now generates a suite of Bash scripts for installation and dependency management. The new installers (install.sh, install\_full.sh, install\_browser.sh) handle Ruby and Node.js setup via mise, manage gem/npm registry mirrors for CN users, and install the openclacky gem and chrome-devtools-mcp. A dedicated script (install\_rails\_deps.sh) installs Ruby 3.3+, Node.js 22+, and PostgreSQL for Rails development. The uninstaller (uninstall.sh) now safely removes all gem versions using the -a flag and cleans up brand wrappers. System dependencies (install\_system\_deps.sh) are installed via Xcode CLT on macOS or apt on Linux.

scripts/build/src · high confidence

New utility modules for argument parsing, environment detection, and file handling

The \lib/clacky/utils\ directory now includes several new modules that enhance how the application handles tool arguments, detects the user's environment, and processes files. \ArgumentsParser\ introduces robust JSON repair logic to handle malformed tool call arguments (such as XML contamination) and schema-aware unwrapping of double-serialized values. \EnvironmentDetector\ provides OS-specific path resolution (WSL, Linux, macOS) and desktop detection, while \BrowserDetector\ locates running Chrome/Edge instances via DevTools ports. \FileProcessor\ and \FileIgnoreHelper\ standardize file uploads, parsing, and directory walking with budget limits and gitignore support. Additionally, \Encoding\ centralizes UTF-8 handling for shell output, \LimitStack\ manages bounded text buffers, and \ChannelPrompt\ formats multi-user chat history.

lib/clacky/utils · high confidence

New version management UI and backend logic

The web interface now includes a dedicated version feature that displays a badge in the sidebar indicating the current version and any available updates. Users can click this badge to open a popover that allows them to initiate an upgrade, view real-time installation logs, and restart the server after an upgrade completes. The system handles the upgrade lifecycle, including checking for updates via the API, managing WebSocket events for upgrade progress, and handling server restarts with automatic reconnection polling.

lib/clacky/web/features/version · high confidence

Project renamed to OpenClacky with comprehensive documentation and Docker support

The project has been renamed from 'clacky' to 'openclacky', reflected in the gem name, repository structure, and all user-facing documentation. This change introduces a new \.clackyrules\ file to guide development, a \CONTRIBUTING.md\ guide for contributors, and a \ROADMAP.md\ outlining future focus areas. Docker support is now officially included with a \Dockerfile\ for building images from source and a \.dockerignore\ file, alongside localized READMEs in Chinese and Japanese to support a broader user base.

(repo-wide) · high confidence

Support for installing skills from local zip files

The skill-add feature now allows users to install skills directly from a local zip file path, in addition to remote URLs. The installer detects whether the source is a local file or a remote URL, handles local path expansion (including tilde), and extracts the skill package to the user's skills directory.

_lib/clacky/default\skills/skill-add/scripts · high confidence

Unified media generation and understanding framework

The \lib/clacky/media\ library now provides a structured, provider-agnostic system for generating and understanding images, video, and audio. A new \Base\ class standardizes response shapes and local file persistence, while the \Generator\ dispatcher routes requests to specific providers based on the configured model's base URL. This enables native support for Alibaba DashScope (Qwen-Image, CosyVoice, HappyHorse) and Volcengine Ark (Seedance video) alongside existing OpenAI-compatible and Gemini adapters, allowing users to leverage these services directly without external gateway wrappers.

lib/clacky/media · high confidence

Architecture

Refactored message format adapters into dedicated modules

The message formatting logic for Anthropic, AWS Bedrock, OpenAI, and the OpenAI Responses API has been extracted from the main codebase into dedicated, standalone modules. This refactoring isolates the specific request-building, response-parsing, and tool-result formatting rules for each provider, ensuring that provider-specific quirks (such as Anthropic's tool\_use ID sanitization, Bedrock's alternating role requirements, or the Responses API's distinct input/output schema) are handled cleanly within their own files without cluttering the core application logic.

_lib/clacky/message\format · high confidence

Behavioural changes

10 commits (1 fix) modifying lib/clacky/web/features/channels

A change to existing behaviour in lib/clacky/web/features/channels — 10 commits (1 fix), 2 files: “feat(channel): add built-in QQ bot adapter (\#615)”; “feat(web): redesign channels page as a compact two-column list”; “feat(channels): add process\_messages toggle for tool-call narration and previews”; and 7 more (refs \#615, \#589, \#599, \#621).

lib/clacky/web/features/channels · medium confidence · unverified

12 commits (4 fixes) modifying lib/clacky/web/features/tasks

A change to existing behaviour in lib/clacky/web/features/tasks — 12 commits (4 fixs), 2 files: “feat(tasks): order plans by enabled state, then newest first”; “fix: display cron with every-N-hours + weekdays pattern correctly”; “feat(web): redesign scheduled tasks page with run history”; and 9 more.

lib/clacky/web/features/tasks · medium confidence · unverified

30 commits (12 fixes) modifying lib/clacky/default\_extensions/git/panels

A change to existing behaviour in lib/clacky/default\_extensions/git/panels — 30 commits (12 fixs), 1 file: “refactor: migrate default\_agents to default\_extensions, unify panel visibility via agent.panels”; “fix(git): raise scope menu and finder above the mobile aside overlay (C-5839) (\#698)”; “feat: refresh git panel on session complete”; and 27 more (refs \#698, \#707, \#699, \#545, \#539, …).

_lib/clacky/default\extensions/git/panels · medium confidence · unverified

30 commits (5 fixes) modifying lib/clacky/billing

A change to existing behaviour in lib/clacky/billing — 30 commits (5 fixs), 2 files: “feat: add Claude Fable 5.1 model”; “fix: merge openclacky billing across all configured api keys”; “chore(models): drop the oc-minimax-m2.7 alias from the client”; and 27 more (refs \#166, \#228, \#580, \#208).

lib/clacky/billing · medium confidence · unverified

48 commits (21 fixes) modifying lib/clacky/web/features/workspace

A change to existing behaviour in lib/clacky/web/features/workspace — 48 commits (21 fixs), 2 files: “feat(web): add Office, PDF and text file icons (\#688)”; “fix(workspace): resolve file://\~/ tilde paths from chat links”; “feat(web): add a tab context menu and reopen tabs after a reload”; and 45 more (refs \#688, \#675, \#634, \#545, \#375, …).

lib/clacky/web/features/workspace · medium confidence · unverified

67 commits (20 fixes) modifying lib/clacky/web/components

A change to existing behaviour in lib/clacky/web/components — 67 commits (20 fixs), 12 files: “fix(onboard): localise device-login errors and drop the user code”; “fix(web): make @ mention menu selectable on the new-session page (C-5780) (\#558)”; “fix(web): page session lists by server-issued time+id cursor (C-5820) (\#669)”; and 64 more (refs \#558, \#669, \#617, \#400, \#566, …).

lib/clacky/web/components · medium confidence · unverified

7 commits (2 fixes) modifying lib/clacky/default\_extensions/preview

A change to existing behaviour in lib/clacky/default\_extensions/preview — 7 commits (2 fixs), 5 files: “chore(preview): move preview tab to end of left-nav order”; “feat(preview): chrome-style toolbar with zoom controls”; “fix(workspace): use single-pane navigation on mobile (C-5779) (\#539)”; and 4 more (refs \#539).

_lib/clacky/default\extensions/preview · medium confidence · unverified

New theme system with dark/light mode support

The UI2 theme system has been refactored to support distinct visual themes (Hacker and Minimal) that automatically adapt to the terminal's background brightness. Users will see appropriate text and symbol colors depending on whether their terminal is in dark or light mode, ensuring readability across different environments.

lib/clacky/ui2/themes · high confidence

Redesigned skills management with search, tabs, and system skill filtering

The skills interface has been redesigned to use a card-based layout with distinct tabs for 'My Skills' and 'Brand Skills'. Users can now filter skills using a new search box in the panel tab bar, toggle the visibility of system-level skills (with the preference persisted in localStorage), and view detailed information for each skill. The underlying store and view logic have been restructured to support these features, including separate data loading for brand-specific skills and improved error handling via in-app toasts.

lib/clacky/web/features/skills · high confidence

Rename CLI entry point to openclacky and add clarky typo redirect

The main executable has been renamed from 'clacky' to 'openclacky' to reflect the project's new name. To improve user experience, a new 'clarky' shim has been added that detects the common typo, warns the user, and automatically redirects them to the correct 'openclacky' command. The original 'clacky' binary remains available but now explicitly sets up the load path before invoking the CLI.

bin · high confidence

Fixes

4 commits (3 fixes) fixing lib/clacky/web/features/archive

A fix in lib/clacky/web/features/archive — 4 commits (3 fixs), 2 files: “fix(data): bulk delete in recycle bin and archive respects filters (C-5826) (\#672)”; “fix(web): page session lists by server-issued time+id cursor (C-5820) (\#669)”; “fix(web): refresh data management lists after sidebar archive/delete (C-5830) (\#673)”; and 1 more (refs \#672, \#669, \#673).

lib/clacky/web/features/archive · medium confidence · unverified

Test coverage

118 commits adding/updating tests in spec/clacky/web; 5 commits adding/updating tests in spec/clacky/billing; 73 commits adding/updating tests in spec/support; Added benchmark test fixture and evaluation results for system prompt alignment; Added comprehensive test coverage for Clacky utility modules; Added comprehensive test coverage for agent cost tracking, compression, and subagent handling; Added comprehensive test coverage for core tools; Added server-side test coverage for API extensions, browser management, and HTTP server components; Added smoke tests for web search providers; Added test coverage for DingTalk, Feishu, Telegram, and Weixin channel adapters; Added test coverage for Feishu bot token retry and progress card logic; Added test coverage for MCP OAuth integration and transport robustness; Added test coverage for UI2 components; Added test coverage for agent core, configuration, and security components; Added test coverage for media generation providers and routing; Added test coverage for the QQ bot adapter; Added tests for UI2 layout, buffer, and progress handling; Added tests for UI2 markdown rendering, view rendering, and controller logic; Added tests for Weixin SendQueue batching and message splitting; Added tests for agent session history and code style enforcement; Added tests for channel configuration, manager binding, and adapter loading; Added tests for media generation skill behavior; Added tests for the UI2 InputArea component; Added tests for the computer-use extension's CLI, geometry, and Windows backend.

Dependencies

Gem renamed to openclacky with expanded dependencies and Ruby 2.6+ support

The project has been renamed from 'clacky' to 'openclacky', with the original gemspec deleted and replaced by a new 'openclacky.gemspec' that enforces a minimum Ruby version of 2.6.0. To support this broader Ruby compatibility and new features, the dependency list has been significantly expanded to include 'faraday' (pinned \< 2.9), 'diffy', 'pastel', 'tty-markdown', 'ruby\_rich', 'chunky\_png', 'rouge', 'webrick', 'websocket', and 'rubyzip' (pinned to 2.4.1). Legacy gem names 'clacky' and 'clarky' are now available as transitional shims that automatically install 'openclacky'. The Gemfile has been updated to conditionally include development dependencies like 'debug', 'parallel\_tests', and 'rubocop' based on the Ruby version, and a new benchmark fixture Gemfile has been added.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 32 → 32 (+0.0)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

Lenses

  • Code Health 25 → 25 (-0.6)
  • Architecture 78 → 77 (-1.2)
  • Maturity 38 → 64 (+26.0)
  • Readiness 42 → 45 (+3.0)
  • Security 29 → 25 (-4.5)
  • Accessibility 37 → 37 (+0.1)
  • Performance 100 → 100 (+0.0)

Resolved (48)

  • (anonymous) (cognitive 27) (lib/clacky/web/features/channels/store.js)
  • (anonymous) (cognitive 29) (lib/clacky/web/features/tasks/store.js)
  • (anonymous) (cognitive 34) (lib/clacky/web/features/workspace/store.js)
  • (anonymous) (cognitive 57) (lib/clacky/web/features/archive/store.js)
  • (anonymous) (cyclomatic 27) (lib/clacky/web/features/tasks/store.js)
  • (anonymous) (cyclomatic 28) (lib/clacky/web/features/channels/store.js)
  • (anonymous) (cyclomatic 35) (lib/clacky/web/features/workspace/store.js)
  • (anonymous) (cyclomatic 54) (lib/clacky/web/features/archive/store.js)
  • (anonymous)._docTypeIcon (cognitive 20) (lib/clacky/web/features/new-session/view.js)
  • (anonymous)._docTypeIcon (cyclomatic 28) (lib/clacky/web/features/new-session/view.js)
  • (anonymous)._initModal::onSelect (cognitive 16) (lib/clacky/web/settings.js)
  • (anonymous)._loadChats (cyclomatic 20) (lib/clacky/web/components/mentions.js)
  • (anonymous)._notifyDesktop (cognitive 16) (lib/clacky/web/components/notify.js)
  • (anonymous)._notifyDesktop (cyclomatic 17) (lib/clacky/web/components/notify.js)
  • (anonymous)._pollDevice (cognitive 16) (lib/clacky/web/components/onboard.js)
  • (anonymous)._startDeviceLogin (cognitive 19) (lib/clacky/web/components/onboard.js)
  • (anonymous)._startDeviceLogin (cyclomatic 17) (lib/clacky/web/components/onboard.js)
  • (anonymous).createViewer.buildImageTab (cognitive 17) (lib/clacky/web/features/workspace/view.js)
  • (anonymous).createViewer.buildImageTab (cyclomatic 17) (lib/clacky/web/features/workspace/view.js)
  • (anonymous)::_docTypeIcon (cognitive 19) (lib/clacky/web/sessions.js)
  • …and 28 more

New (89)

  • (anonymous) (cognitive 31) (lib/clacky/web/features/tasks/store.js)
  • (anonymous) (cognitive 33) (lib/clacky/web/features/channels/store.js)
  • (anonymous) (cognitive 38) (lib/clacky/web/features/workspace/store.js)
  • (anonymous) (cognitive 62) (lib/clacky/web/features/archive/store.js)
  • (anonymous) (cyclomatic 29) (lib/clacky/web/features/tasks/store.js)
  • (anonymous) (cyclomatic 34) (lib/clacky/web/features/channels/store.js)
  • (anonymous) (cyclomatic 39) (lib/clacky/web/features/workspace/store.js)
  • (anonymous) (cyclomatic 59) (lib/clacky/web/features/archive/store.js)
  • (anonymous)._branchErrorText (cognitive 19) (lib/clacky/web/features/new-session/view.js)
  • (anonymous)._branchErrorText (cyclomatic 17) (lib/clacky/web/features/new-session/view.js)
  • (anonymous)._branchNameError (cognitive 27) (lib/clacky/web/features/new-session/view.js)
  • (anonymous)._branchNameError (cyclomatic 19) (lib/clacky/web/features/new-session/view.js)
  • (anonymous)._buildBubbleHtml (cognitive 19) (lib/clacky/web/features/new-session/view.js)
  • (anonymous)._handleHistory (cyclomatic 19) (lib/clacky/web/components/composer.js)
  • (anonymous)._initModal (cognitive 25) (lib/clacky/web/settings.js)
  • (anonymous)._openBranchPopover (cognitive 27) (lib/clacky/web/features/new-session/view.js)
  • (anonymous)._openBranchPopover (cyclomatic 24) (lib/clacky/web/features/new-session/view.js)
  • (anonymous)._openCreateBranchModal (cognitive 29) (lib/clacky/web/features/new-session/view.js)
  • (anonymous)._openCreateBranchModal (cyclomatic 26) (lib/clacky/web/features/new-session/view.js)
  • (anonymous)._renderTaskCard (cognitive 16) (lib/clacky/web/features/tasks/view.js)
  • …and 69 more

Changes since last survey

  • 134 commits — 76 feature/other, 58 fixes

By area

  • lib/clacky — 123 commits
  • (root) — 7 commits
  • spec/clacky — 4 commits

Notable commits

  • fix: fix(channel): keep routing messages to archived channel sessions (C-5824) (#671)
  • fix: fix(data): bulk delete in recycle bin and archive respects filters (C-5826) (#672)
  • fix: fix(dir-picker): exit address mode after entering current path (C-5856) (#703)
  • fix: fix(extension): include manifest path in loader cache fingerprint
  • fix: fix(git): drop a pushed commit pick on refresh (C-5840) (#699)
  • fix: fix(git): raise scope menu and finder above the mobile aside overlay (C-5839) (#698)
  • fix: fix(git):force english git output so checkout errors are recognised (C-5850) (#701)
  • fix: fix(git-panel): close file menu on revert and refresh (C-5842) (#707)
  • fix: fix(git-panel): keep the empty commit list from saying it twice
  • fix: fix(git-panel): keep the scope pill on the first row of a narrow toolbar
  • fix: fix(git-panel): left-align the tool row when the bar wraps
  • fix: fix(git-panel): refetch the commit list on refresh
  • fix: fix(git-panel): show pane scrollbar on hover in split diff (C-5845) (#711)
  • fix: fix(onboard): localise device-login errors and drop the user code
  • fix: fix(open-with): keep submenu attached to its parent menu (C-5843) (#708)
  • fix: fix(preview): keep the address bar in sync with in-frame navigation
  • fix: fix(replay): keep chunk heads that continue an earlier turn (C-5817) (#662)
  • fix: fix(search): store web search API keys per provider so switching providers never reuses another provider's key (C-5837) (#685)
  • fix: fix(server): detect open-with apps for extension-less files
  • fix: fix(server): end the ask_user countdown when switching to manual so the session awaits feedback (C-5836) (#684)
  • …and 114 more

Architecture

  • Unchanged — 0 containers · 1 contexts · 0 edges

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

clacky-ai/openclacky was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 6 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 58e9c259bc7d76507456d1c27c2e26d6c0f2d196 — the exact code this score is about.
  • Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-60d1b390edf0.