CLI Guide

$ human --help

human — compile structured English into full-stack applications

Usage:
  human <command> [arguments]

Commands:
  build <file>      Compile to IR and generate code
  check <file>      Validate a .human file
  init [name]       Create a new Human project
  run               Start the development server
  test              Run generated tests
  explain [topic]   Learn Human syntax by topic
  syntax [section]  Full syntax reference
  fix <file>        Find and auto-fix common issues
  doctor            Check environment health
  deploy [file]     Deploy the application
  eject [path]      Export as standalone code
  storybook         Launch Storybook dev server
  audit             Display security and quality report
  ask <desc>        Generate .human from description
  how <question>    Ask about Human language usage
  suggest <file>    Get improvement suggestions
  edit <file>       Open interactive TUI editor
  version           Print the compiler version
  help              Show this help message

Global flags:
  --no-color        Disable colored output

$ git clone https://github.com/barun-bash/human.git
$ cd human
$ make build
$ make install    # copies to /usr/local/bin

$ human version
human v0.4.2 (go1.25, darwin/arm64)

$ human build app.human

✓ Parsed app.human (0 errors, 0 warnings)
✓ Generated 69 files across 4 targets
✓ Quality: 14 tests, 0 security issues, 0 lint warnings
✓ Output: .human/output/

$ human build app.human --inspect
# prints IR as YAML — useful for debugging

$ human check app.human

✓ app.human is valid (0 errors, 2 warnings)
  W201: Missing "build with:" block — defaults will be used
  W301: Page "settings" has no navigation entry

$ human init my-app

✓ Created my-app/app.human
  Next: human build my-app/app.human

$ human explain pages

Pages
Define the screens of your application.

Syntax:
  page <name>:
    path: "/..."
    layout: ...
    sections:
      ...

Example:
  page Dashboard:
    path: "/dashboard"
    layout: sidebar
    sections:
      - hero: "Welcome back, {user.name}"
      - stats grid showing active projects, completed tasks
      - recent activity feed

$ human syntax --search "authentication"
# shows all syntax related to authentication

$ human fix app.human

Found 3 fixable issues:
  1. Missing "build with:" block → added with defaults
  2. Inconsistent indentation on line 14 → fixed
  3. Deprecated "database:" → replaced with "data models:"

✓ Applied 3 fixes to app.human

$ human doctor

✓ Human compiler v0.4.2
✓ Go 1.25
✓ Node.js 22.0.0
✓ Docker 27.0.0
⚠ Python not found — needed for Python backend targets
⚠ Terraform not found — needed for infrastructure targets

Environment: 4/6 checks passed
Run "human doctor" after installing missing tools.

$ human eject ./my-standalone-app

✓ Ejected to ./my-standalone-app
  The project is now fully standalone — no Human dependency.

$ human ask "a task management app with kanban boards and team collaboration"

Generating .human file...

app "TaskFlow":
  description: "Kanban-style task management with real-time collaboration"
  ...

✓ Generated taskflow.human (validated)
  Tokens: 847 in / 1,203 out

$ human how "add drag and drop to a kanban board"

$ human

  human_ v0.4.2

  Type /help for commands, /open to load a project.

human> /open examples/taskflow/app.human
✓ Loaded app.human (TaskFlow)

human> /build
✓ Built 69 files in 1.2s

human> /run
Starting dev server on :3000...

{
  "llm": {
    "provider": "anthropic",
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 4096,
    "temperature": 0.0
  }
}

{
  "llm": {
    "provider": "anthropic",
    "model": "claude-sonnet-4-20250514",
    "api_key": "sk-ant-..."
  },
  "mcp": [
    {
      "name": "figma",
      "command": "npx",
      "args": ["@anthropic/mcp-server-figma"],
      "env": { "FIGMA_ACCESS_TOKEN": "..." }
    }
  ]
}

$ human
human> /instructions init   # create template HUMAN.md
human> /instructions edit   # open in $EDITOR