kukicha

Kukicha

A readable language that ships as a single binary.

kukicha.org | Quick Reference | Tutorials | Stdlib Reference

A taste of Kukicha

Triage open GitHub issues with an LLM. Fetch, classify in parallel, keep the urgent ones, sort, print.

# triage.kuki — classify open issues with Claude, flag the urgent ones
import "stdlib/concurrent"
import "stdlib/fetch"
import "stdlib/json" as jsonpkg
import "stdlib/llm/chat"
import "stdlib/slice"
import "stdlib/sort"

type Issue
    number int
    title string
    body string

type Verdict
    number int
    severity int # 1 = trivial .. 5 = on fire
    kind string # bug | feature | docs | question
    summary string

func triage(issue: Issue) Verdict
    reply := chat.New("anthropic:claude-sonnet-4-6")
        |> chat.JSONMode()
        |> chat.System(`Classify GitHub issues. Reply JSON: {severity:1-5, kind, summary}`)
        |> chat.Ask("{issue.title}\n\n{issue.body}") onerr return {}

    v := jsonpkg.ParseString of Verdict from reply onerr return {}
    v.number = issue.number
    return v

func main()
    url := "https://api.github.com/repos/golang/go/issues?per_page=20"
    issues := fetch.GetJson of list of Issue from url onerr panic "github: {error}"

    urgent := issues
        |> concurrent.MapWithLimit(4, triage)
        |> slice.Filter(v => v.severity >= 4 and v.kind isnt "question")
        |> sort.ByKey(v => -v.severity)

    print("Needs attention:")
    for v in urgent
        tag := if v.severity equals 5 then "[ON FIRE]" else "[P{v.severity}]"
        print("  {tag} {v.kind}  #{v.number}  {v.summary}")

You can read this top-to-bottom without knowing the language: fetch issues, classify four at a time, filter the severe ones that aren't just questions, sort, print. English operators (and, isnt, equals, if … then … else), pipes that flow left-to-right, and stdlib names (fetch.GetJson, slice.Filter, concurrent.MapWithLimit, sort.ByKey) carry the weight. onerr keeps error handling out of the flow.

kukicha build triage.kuki produces a single static binary. Drop it on any server. No runtime to install.

Why Kukicha?

• Readable by anyone on your team. Code that the on-call sysadmin, the new hire, and your future self can pick up cold.
• Ships as one file. kukicha build produces a static binary — copy it to a server and run.
• Batteries included. fetch, shell, files, db, llm, mcp, container, concurrent, crypto, html and 30+ more — no three-day debate over which HTTP library to pick.
• Safe defaults. Compile-time checks for SQL injection, XSS, shell injection, path traversal, and SSRF. Errors are values handled with onerr.
• No lock-in. kukicha brew file.kuki converts any file back to standard Go.

Quickstart

Grab a pre-built binary from GitHub Releases (Linux, macOS, Windows). Or, if you already have Go 1.26+ installed:

go install github.com/kukichalang/kukicha/cmd/kukicha@v0.9.2
mkdir myapp && cd myapp
kukicha init

kukicha init initializes a Go module (if go.mod is absent), extracts the stdlib, downloads dependencies, and writes an AGENTS.md language reference. Add .kukicha/ to your .gitignore.

Create hello.kuki:

function main()
    name := "World"
    print("Hello, {name}!")

kukicha run hello.kuki

Commands

Already use Go?

Every .go file is valid .kuki — Kukicha is a strict superset. The Kukicha forms are sugar that desugars to standard Go before compilation; you can mix and match freely, drop them when they don't help, and run kukicha-blend on existing Go to see suggestions.

kukicha-blend main.go            # see what idioms apply
kukicha-blend --diff ./pkg/      # preview changes
kukicha-blend --apply main.go    # convert in place
kukicha brew main.kuki           # and anytime, back to Go

The translation table:

The stdlib stays useful either way: fetch.GetJson of T from url onerr ... reads the same whether the surrounding code is list of string or []string.

Editor support

• VS Code: https://github.com/kukichalang/vscode-kukicha
• Zed: https://github.com/kukichalang/zed-kukicha
• Other: make install-lsp and point your editor at kukicha-lsp

Documentation

• Quick Reference — Go-to-Kukicha translation table
• Agent Workflow Tutorial — prompt AI, review, ship
• Beginner Tutorial — first program, variables, functions
• AWS Deployment Starter — first deployment helper from AWS console concepts
• Production Patterns — databases, auth, retry
• FAQ | Contributing

Version: 0.9.2 | License: MIT

[!NOTE] Portions of this codebase were written with AI assistance. Commits are reviewed by human maintainers before merge.