CLI Internals
CLI Reference
Overview

CLI Reference

Command Line Interface Documentation

Complete reference for all CLI commands, options, and configuration.


Commands

architech new <genome-file>

Create a new project from a TypeScript genome.

architech new my-app.genome.ts
architech new my-app.genome.ts --dry-run
architech new my-app.genome.ts --verbose

Options:

  • -d, --dry-run - Preview without executing
  • -v, --verbose - Detailed logging
  • -q, --quiet - Minimal output

architech add <feature>

Add feature to existing project (V2).

architech list-genomes

List available pre-built genomes.

architech analyze <repo>

Analyze existing repository structure.

architech scale

Scale project to monorepo (V2).


Configuration

Global config: ~/.architech/config.json

{
  "marketplace": "@thearchitech.xyz/marketplace",
  "cache": "~/.architech/cache"
}

Project config: ./architech.config.json

{
  "marketplace": "@company/marketplace",
  "modules": [...],
  "version": "1.0.0"
}

Environment Variables

  • ARCHITECH_MARKETPLACE - Override marketplace
  • ARCHITECH_CACHE_DIR - Custom cache location
  • ARCHITECH_VERBOSE - Enable verbose logging

Exit Codes

  • 0 - Success
  • 1 - General error
  • 2 - Validation error
  • 3 - Blueprint execution error