aict — Coreutils for AI Agents

Unix coreutils rebuilt for AI agents — structured XML/JSON output, zero parsing, zero ambiguity.

CI Go version Latest release License: MIT


What is aict?

aict is a single Go binary that reimplements ~22 Unix CLI tools (ls, grep, cat, find, stat, diff, etc.) with structured XML/JSON output designed for AI coding agents.

Every time an AI agent runs ls, grep, or cat, it wastes tokens parsing human-readable output. aict gives you the same tools you already know, but the output is structured. No parsing. No regex. Just data.

What You Get

$ aict ls src/
<ls timestamp="1234567890" total_entries="3">
  <file name="main.go" path="src/main.go" absolute="/project/src/main.go"
        size_bytes="2048" size_human="2.0 KiB" modified="1234567890" modified_ago_s="3600"
        language="go" mime="text/x-go" binary="false"/>
  <file name="utils.go" path="src/utils.go" absolute="/project/src/utils.go"
        size_bytes="1024" size_human="1.0 KiB" modified="1234567890" modified_ago_s="3600"
        language="go" mime="text/x-go" binary="false"/>
  <directory name="internal" path="src/internal"/>
</ls>

Every field is labeled. Every path is absolute. Every timestamp is a Unix epoch integer. The agent knows exactly what it is looking at.

Quick Start

# Install
go install github.com/synseqack/aict@latest

# Use it
aict ls src/
aict grep "func" . -r
aict cat main.go

Key Features

FeatureDetail
Structured outputXML, JSON, or plain text for every tool
Zero dependenciesGo standard library only (MCP server excepted)
Single binaryDrop it anywhere and it works
Enriched metadataLanguage detection, MIME types, epoch timestamps
MCP serverConnect to Claude, Cursor, and other AI assistants
Cross-platformLinux, macOS, Windows (partial)
SectionWhat You’ll Find
InstallationBuild from source, go install, Docker
UsageCommands, flags, environment variables
Output ModesXML, JSON, plain text explained
Tools ReferenceDocumentation for all 22+ tools
MCP ServerConnect to Claude, Cursor, etc.
XML Schema ReferenceComplete output schema for every tool
Migration GuideGNU coreutils → aict mapping
Integration GuideUsing aict with AI coding agents
BenchmarksPerformance vs GNU coreutils
FAQCommon questions answered
ContributingHow to add tools, code style, testing

Why This Exists

We built AI coding agents that needed to read files, search codebases, and compare directories. Standard CLI tools are designed for humans. Every parsing attempt was brittle.

This gives you the same capabilities, but the output is unambiguous. The agent does not guess. It reads.