ApiHug REPL

ApiHug REPL is the terminal-first entry point for command discovery, workflow installation, and module-aware navigation.

What It Is

The REPL gives you:

• a command shell for ApiHug tooling
• module-aware navigation
• BMAD installation and update commands
• a consistent terminal surface for multi-module projects

Why It Matters

Not every team wants to work only from the IDE. REPL gives the same ApiHug toolchain a scriptable, terminal-oriented surface.

How It Fits

1. Enable the plugin

Add the REPL plugin to gradle/libs.versions.toml:

[versions]
apihugVersion = "2.0.2-RELEASE"

[plugins]
hope-repl = { id = "com.apihug.repl", version.ref = "apihugVersion" }

Enable it in build.gradle:

plugins {
  alias(libs.plugins.hope.repl)
}

2. Initialize the REPL

./gradlew :hope

That generates the apihug and apihug.bat launchers.

3. Start using it

Common first commands:

help
ls
cd --module-name demo-app-proto
pwd

Troubleshooting

"Cannot resolve external dependency" during :hope

Older projects may be missing repository declarations in the root build.gradle. Add them before rerunning the task:

repositories {
  mavenLocal()
  mavenCentral()
  maven { url "https://repo.spring.io/libs-release" }
  maven { url "https://repo.spring.io/milestone" }
}

Next Step

1. Use REPL to install ApiHug BMAD
2. Return to Tool Chain for the rest of the generation commands