Use cases

Use Gihanga from the terminal or the desktop workspace.

Gihanga supports two working modes: the Kinyarwanda-first CLI for fast local commands, and the desktop workspace for visual project review, agent planning, code context, and guided learning.

UpskillsAfrica Foundation logoGihanga modes
Two ways to workCLI: fast commands and project startersDesktop: visual workspace and agent planBoth: local-first learning by building

CLI mode

Fast project actions from the terminal.

CLI

Check the local environment

Confirm that the machine is ready before a class, lab, or build session.

gihanga genzura
CLI

Show available templates

List starter directions for AI, web, and hardware-oriented projects.

gihanga ingero
CLI

Create a new project

Start a named folder from a practical template and begin building immediately.

gihanga tangira ishuri-ai ai-ibanze
CLI

Run background agent work

Process queued project tasks when a local runner is connected to a workspace flow.

gihanga umukozi:kurikirana

Desktop mode

Visual workspace for guided building.

Desktop

Open a project folder

Work from a local folder and keep project files close to the learner or team.

Desktop

Review the agent plan

Read the proposed steps before changing code, docs, or project structure.

Desktop

Inspect file changes

Use the workspace to understand what changed and why it matters.

Desktop

Learn with explanations

Turn each build step into a teaching moment for learners, cohorts, and project teams.

CLI + Desktop

Practical work Gihanga should support.

AI projects

Build agent-assisted apps and automations

Plan prompts, scripts, workflows, and simple AI-enabled tools for learning and local productivity.

Web apps

Create pages, routes, and small product prototypes

Use templates and guided changes to build practical Nuxt, Cloudflare, or static web projects.

Hardware labs

Prepare device and maker exercises

Structure code, notes, and lab instructions for attendance tools, sensors, and classroom demos.

Debugging

Find and fix project issues

Ask for a plan, inspect likely causes, and apply changes in small reviewable steps.

Documentation

Write README files and learner notes

Explain setup, usage, project goals, and next steps so others can understand the work.

Courses

Support UpskillsAfrica course projects

Turn lessons into buildable project folders that learners can run, edit, and explain.

Founders

Prototype internal tools and MVPs

Move from idea to working local prototype without losing the reasoning behind the files.

Schools

Run repeatable computer-lab sessions

Use starter templates and guided steps across machines in a classroom or cohort setting.

Teams

Review a shared project direction

Use plans, explanations, and project context to align before implementation.

Example flow

Start in CLI, continue in Desktop.

gihanga genzura
gihanga ingero
gihanga tangira ishuri-ai ai-ibanze
# open the folder in Gihanga Desktop
# review the plan, build, run, and learn