haiku-claude-cli CLAUDE.md

CLAUDE.md

Guidance for Claude Code when working in this repository.

Project

A native Claude CLI for Haiku OS. Single C++17 binary; runtime dependencies are libcurl, OpenSSL, libedit, and nlohmann/json. Targets Haiku x86_64 (primary) and macOS (dev/prototype only).

Source lives in src/. One translation unit per module; each module is a .cpp + .h pair under a lowercase namespace matching the filename (tui::, repl::, tools::, etc.). main.cpp is the entry point and contains the REPL loop, tool dispatch, and Claude API integration.

Build & Test

# ── On Taurus (Haiku — canonical target) ──
make                     # dev build  → build/claude        (-O2)
make release             # opt build  → build-release/claude (-O3 -flto -s)
make test                # run tests
make install             # install to /boot/system/non-packaged
make package             # build HPKG (requires Haiku `package` tool)

# Static analysis and security audit
make lint                # cppcheck  — warning/performance/portability
make security            # flawfinder — CWE security audit (level 3+)
make security-full       # flawfinder — full scan (level 2+)
make check               # lint + security in sequence (CI / pre-release)

# ── macOS / nix (prototype only) ──
nix develop              # enter dev shell (curl, openssl, libedit, nlohmann_json)
nix develop -c make      # build
nix develop -c make test # test

Build artifacts go to build/ (dev) or build-release/ (release). The Makefile uses pkg-config for all dependency flags and works with both gcc (Haiku) and clang (macOS/nix) without modification.

Source Layout

src/
  main.cpp       — entry point, REPL loop, Claude API, tool dispatch
  tui.cpp/h      — terminal UI: color, spinner, markdown renderer,
                   status bar (DECSTBM), select_option menu
  repl.cpp/h     — libedit wrapper: line editing, history, tab
                   completion, bracketed paste, multi-line input
  tools.cpp/h    — tool registry, permission checks, previews
  commands.cpp/h — slash-command dispatch (/help, /model, /compact…)
  hooks.cpp/h    — lifecycle hooks (SessionStart, PreToolUse, etc.)
  mcp.cpp/h      — MCP stdio-transport client
  oauth.cpp/h    — OAuth 2.0 + PKCE flow
  paths.cpp/h    — platform config/data paths
  stats.cpp/h    — per-turn token accounting
  notify.cpp/h   — Haiku BNotification wrapper
  telegram.cpp/h — Telegram bridge (optional)
tests/           — shell-based functional tests
ci_scripts/      — test.sh and release helpers
docs/            — GIT_WORKFLOW.md, ROADMAP.md, claude.1 man page
assets/          — claude-icon.hvif (Haiku vector icon)