ccx-go

skill
Security Audit
Warn
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Pass
  • Code scan — Scanned 2 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This tool is a command-line AI coding assistant written in Go, designed as an open-source alternative to proprietary tools like Claude Code. It features a terminal user interface (TUI) and utilizes a multi-agent architecture to process and execute tasks.

Security Assessment
Based on the audit, no dangerous code patterns or hardcoded secrets were found in the scanned files, and it does not request dangerous system permissions. However, as an AI coding assistant, it inherently interacts with the Claude API, meaning it makes external network requests. The tool also possesses the capability to execute real tools and shell commands on your machine via its pluggable tool system. Users should be aware that it may access sensitive codebases and execute locally generated commands. Overall risk is rated as Medium due to the inherent execution capabilities of autonomous coding agents.

Quality Assessment
The project is licensed under the permissive MIT license and features a clean, well-documented architecture utilizing popular Go libraries. It is highly active, with its last code push occurring just today. However, the project currently has very low community visibility and engagement, boasting only 5 GitHub stars. Consequently, the community trust level is low, meaning the codebase has not been extensively peer-reviewed by a wide audience.

Verdict
Use with caution: the code appears clean and well-maintained, but its low community visibility and inherent ability to execute local commands warrant strict supervision when handling sensitive projects.
SUMMARY

Go implementation of an AI coding assistant CLI. Zero-dependency binary, goroutine-based agents, Bubbletea TUI.

README.md

ccx-go

A Go implementation of an AI coding assistant CLI, inspired by Claude Code's architecture. Zero-dependency single binary with goroutine-based multi-agent orchestration.

Why CCX?

CCX is a family of clean-room AI coding assistant implementations, built as open-source alternatives to proprietary tools. Each implementation is designed from the ground up using publicly documented API specifications and common patterns in AI-assisted development.

Go was a natural first choice -- the language has a proven track record of rewriting developer tools into fast, single-binary alternatives (gh, lazygit, k9s, fzf). ccx-go follows that tradition: a full working implementation with real tool execution, TUI, and agent system -- not just a metadata wrapper.

For comparison, instructkr/claw-code (41.7k stars) took a Python metadata/harness approach. CCX takes a different path with full language-native implementations and real test suites.

Why Go?

  • Single static binary (~20-30MB) -- no runtime dependencies
  • Goroutines -- perfect for parallel agent spawning, natural fit for multi-agent orchestration
  • Bubbletea/Charm -- the best TUI ecosystem across any language
  • Fast compilation -- full build in 5-15 seconds, cross-compile to all platforms
  • Proven ecosystem -- follows the path of gh, lazygit, k9s, fzf

Architecture

Inspired by architecture analysis of Claude Code:

  • Tool System: Pluggable tools with permission gating and concurrent execution
  • Agent Spawning: Goroutine-per-agent with context cancellation and channel-based communication
  • TUI: Bubbletea (Elm Architecture) with Lipgloss styling and Glamour markdown rendering
  • Context Management: Multi-layer compression (micro, auto, session, full)
  • MCP Protocol: Model Context Protocol client for tool/resource discovery
  • Permission System: Rule-based DSL with interactive prompts
  • Streaming API: SSE-based streaming from Claude API with tool_use handling

Tech Stack

Component Library
TUI Framework bubbletea + lipgloss + bubbles
Markdown glamour
Syntax Highlighting chroma
CLI Parsing cobra + viper
HTTP Client net/http (stdlib)
Schema Validation go-jsonschema
Config viper (TOML/JSON/YAML)
Testing testify + teatest

Project Structure

cmd/
  claude/          # Main CLI entry point
internal/
  agent/           # Agent spawning and lifecycle
  api/             # Claude API client (streaming, tool_use)
  compact/         # Context compression (4 layers)
  config/          # Settings cascade, CLAUDE.md parsing
  mcp/             # MCP protocol client
  permission/      # Permission DSL, rules, classifier
  query/           # Main query loop
  skill/           # Skill loading and execution
  tool/            # Tool interface and registry
  tools/           # Built-in tool implementations
    bash/
    fileread/
    fileedit/
    filewrite/
    glob/
    grep/
    agent/
    webfetch/
  tui/             # Bubbletea UI components
    chat/
    prompt/
    permission/
    progress/
  memory/          # Memory system (user, project, feedback, reference)
pkg/
  types/           # Shared types
  schema/          # JSON schema utilities

Getting Started

go install github.com/anton-abyzov/ccx-go/cmd/claude@latest

Development

git clone https://github.com/anton-abyzov/ccx-go.git
cd ccx-go
go build ./cmd/claude
go test ./...

License

MIT

Reviews (0)

No results found