# clacky-ai/openclacky

The most Token-efficient open-source AI Agent

Repository: https://github.com/clacky-ai/openclacky
Canonical: https://ross.abutalabs.com/products/openclacky
Homepage: https://www.openclacky.com/
Language: Ruby
License: MIT
License Family: permissive
Topics: agent, skills, agent-framework
Last push: 2026-09-02T23:52:40+00:00

## Health v2 (maintenance only)
Score: 79/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 100, release rhythm 87, longevity 17
- inputs: {"age_days": 246, "days_push": 0, "days_rel": 6, "gap_med": 0, "n_releases_24m": 126}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1184, forks 105 (observed 2026-09-03T02:15:10.032192+00:00)

## What it is
OpenClacky is an open-source (MIT) AI agent platform written in Ruby that runs locally, offering a CLI and Web UI for completing tasks via Skills (capability packages), file/command/browser access, and long-term memory. It emphasizes token efficiency through a minimal 16-tool set, near-100% prompt cache hit rates, and BYOK support for any OpenAI-compatible model.

## Use cases
- run an AI agent locally that can read and write files and execute commands
- reduce LLM token costs when using an open-source coding or task agent
- use Claude Code-style agent with my own API key (BYOK)
- automate recurring tasks like weekly reports or news digests with scheduled agent runs
- integrate an AI agent into Feishu, WeCom, WeChat, Discord, or Telegram
- create and share reusable AI workflow skills or publish them to a marketplace
- control a browser to automate web tasks with an AI agent

## When to choose
- you want a Claude Code-class open-source agent with lower token spend
- you need BYOK model freedom across OpenAI, Anthropic, Google, and other providers
- you want local execution with file, command, and browser access plus a Web UI and CLI
- you want a skill ecosystem with self-evolving, shareable capability packages

## When to avoid
- you need a fully managed cloud agent service without running anything locally
- you require Anthropic-only subscription-style billing instead of BYOK
- you need a mature multi-agent orchestration framework rather than a single efficient agent
- your stack requires a Python or JavaScript agent SDK rather than a Ruby-based tool

## Facets
- artifact type: application
- maturity: active
- function: agent-framework, llm-inference, cli, chatbot, mcp, workflow-automation, browser-extension
- domain: large-language-models, developer-tools
- platform: windows, cross-platform, cli, ruby
- tags: ai-agent, token-efficiency, byok, skills, skill-marketplace, im-integration, browser-automation, local-agent, prompt-caching, open-source-agent, ai-agents, automation, command-line, macos, linux, web-server

## Member repositories
- clacky-ai/openclacky (main) score 79

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:10.032192+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:27:04.314604+00:00, confidence not recorded.
  - readme: https://github.com/clacky-ai/openclacky (fetched 2026-09-03T02:15:10.032192+00:00, sha 7fbfb94f31ef)
  - homepage: https://www.openclacky.com/ (fetched 2026-08-29T12:33:09.027821+00:00, sha bb6490ee8fdd)
  - site_page: https://www.openclacky.com/features (fetched 2026-08-29T12:33:09.037127+00:00, sha 5db625305603)
  - site_page: https://www.openclacky.com/docs/tech-deep-dive (fetched 2026-08-29T12:33:09.044271+00:00, sha eec6ee214ff9)
  - site_page: https://www.openclacky.com/docs (fetched 2026-08-29T12:33:09.041774+00:00, sha e54aa14736d8)
  - site_page: https://www.openclacky.com/docs/installation (fetched 2026-08-29T12:33:09.046727+00:00, sha 4b6a5df22ec1)
  - site_page: https://www.openclacky.com/pricing (fetched 2026-08-29T12:33:09.039190+00:00, sha 906031bc4d97)
- Data as of 2026-08-30T08:39:29.467469+00:00.