Ikaitla Engine – Multi-Profile CLI System

Get Ikaitla

mkdir -p my-cli-project && cd my-cli-project
# ...WIP

Perspective

1. One binary with infinite profiles.
2. Add a profile by creating a folder in cmd/<profile-name>/ with commands.
3. We build once and get all the profiles automatically.

Core Principles

1. No boilerplate: The filesystem structure IS the configuration
2. Auto-discovery: Commands and profiles discovered at generation time
3. Single build: One go build command generates everything
4. Profile isolation: Each profile is independent and self-contained
5. No manual registration: No init(), no explicit wiring, no central declarations

Design Philosophy

1. Convention over configuration: Structure implies behavior
2. Fail fast: Invalid profiles fail at generation, not runtime
3. Developer ergonomics: Minimal cognitive load, maximum clarity
4. Production ready: Type-safe, testable, maintainable

Architecture

.
├── bin
├── build.sh
├── cmd
│   └── <profile>                  # Profile discovered by name
│       ├── generated.go           # list of commands (generated on build)
│       ├── metadata.go            # Profile config (version, brand, settings)
│       └── <command-name>.go      # Command: New<OperationName>Cmd()
├── framework
│   ├── autodiscovery.go           # Auto-discovery generator
│   ├── framework.go               # config (EngineName, EngineVersion, EngineTagline)
│   ├── build-info.go              # config (RepoModulePath, ProfilePackageImportPath,
│   │                                      # CmdProfilesImportBase, ProfileWiringOutputFile,
│   │                                      # MainRegistryOutputFile)
│   ├── profile
│   │   └── profile-metadata.go
│   └── ui                         # UI Library
│       ├── colors.go
│       ├── output.go
│       ├── progress.go
│       ├── table.go
│       └── ui_test.go
├── generated_profiles.go          # list of profiles (generated on build)
├── go.mod
├── go.sum
├── LICENSE
├── main.go                        # Entry point: binary name → profile selector
└── Makefile

Commands

# Development
go generate ./...     # Generate all wiring code
go build             # Build binary + create symlinks
go test ./...        # Run all tests

# Single-command build
go build             # Runs generation automatically via build tags

# Installation
make install         # Copy to ~/.local/bin/

Adding a New Profile

1. Create cmd/newprofile/metadata.go
2. Add command files with NewXxxCmd() functions
3. Run go build
4. Done. Binary newprofile is ready.

Future Extensions

• Plugin system for external profiles
• Dynamic command loading
• Profile inheritance and composition
• Built-in update mechanism
• Telemetry and crash reporting

---

• License: Dual (Numerimondes + EPL-2.0)
• Creator: El Moumen Yassine