gjalla 0.5.0

Gjalla CLI — architecture guardrails for AI coding agents

Gjalla CLI

Architecture guardrails for AI coding agents.

Installation

pip install gjalla

Commands

Command	Description
init	Initialize gjalla in a repository (API key, project linking, guardrails, MCP)
status	Show configuration status
setup	Install attestation guardrails (hooks, scripts, agent guidance)
check	Validate commit attestation (used by pre-commit hook)
attest	Create commit attestation (interactive or programmatic)
connect	Link a Gjalla account and project to an existing local setup
show	Show cached project context (rules, arch, state, capabilities, example)
sync	Upload pending attestations to gjalla cloud and refresh cache
mcp	Manage MCP server integration (mcp install)

---

User Guide

Initial Setup

gjalla init

Walks through a 7-step setup:

1. Check git repository
2. Configure API key (optional — skip for local-only mode)
3. Verify API key
4. Select project
5. Create .gjalla/ project config
6. Install commit attestation guardrails
7. Install MCP server for Claude Code

Use gjalla connect later to link a project if you started in local-only mode.

Daily Usage

Automatic (via pre-commit hook):

• gjalla check runs on each git commit and validates the attestation

Manual / Agent workflow:

git add <files>
gjalla attest            # interactive mode
git commit -m "message"

Programmatic (for agents/scripts):

gjalla attest \
  --staged-diff-hash $(git diff --staged | shasum -a 256 | cut -d' ' -f1) \
  --agent claude-code --provider anthropic --model claude-opus-4-6 \
  --summary "Added rate limiting to auth endpoints" \
  --rules '{"checked": true, "applicable": [...]}' \
  --arch-changes '{"architecture": {"elements": [...], ...}, "data_flows": {"changed": false}}'

Viewing Project Context

gjalla show rules          # Project rules
gjalla show arch           # Architecture overview
gjalla show state          # Full cached state (JSON)
gjalla show capabilities   # Project capabilities
gjalla show example        # Attestation template

If the cache is stale, run gjalla sync to refresh it.

Checking Status

gjalla status

Shows: git repo, global config, API key, project mapping, project config, guardrails, telemetry, attestation log.

Configuration

Global config: ~/.gjalla/config.yaml

api_key: "your-api-key"

Project config: .gjalla/config.yaml (in repo root)

Environment variables:

• GJALLA_API_KEY — overrides config file API key

---

Requires Python >= 3.10. Questions or feedback: [e-mail]