GenericAgent_project is the working umbrella repository for the GenericAgent
modernization effort.
The main implementation is ga_engineered/, which is uploaded
directly in this repository as normal source code. The other directories are
kept as child repositories because they are either the legacy upstream or
external references used during the migration.
| Path | Role |
|---|---|
ga_engineered/ |
Primary engineered GenericAgent runtime and TUI. This is the code to install, run, and develop. |
GenericAgent/ |
Legacy GenericAgent repository used for behavior compatibility and migration references. |
free-code/ |
Reference repository for free-code/Claude-Code-style TUI behavior. |
hermes-agent/ |
Reference repository for provider/auth/CLI/TUI patterns. |
docs/ |
Parent-level architecture notes and generated architecture diagram. |
AGENTS.md |
Workspace-level agent instructions and development policy. |
cd ga_engineered
uv sync --extra dev
SKIP_INSTALL=1 ./scripts/build_tui.sh
uv run GenericAgentThe engineered package exposes three equivalent entry points:
uv run GenericAgent
uv run ga
uv run gaeFor global installation:
cd ga_engineered
SKIP_INSTALL=1 ./scripts/build_tui.sh
uv tool install --force .
GenericAgentStart with ga_engineered/README.md, then use:
ga_engineered/docs/INSTALLATION.mdga_engineered/docs/CONFIGURATION.mdga_engineered/docs/DEPLOYMENT.mdga_engineered/docs/DEVELOPMENT.mdga_engineered/docs/TUI.mdga_engineered/docs/COMMANDS.md
The most important configuration file is project-local
.generic-agent/settings.json; global state and credentials live under
$GENERIC_AGENT_HOME (default ~/.generic-agent).
GenericAgent, free-code, and hermes-agent are tracked as child Git
repositories/submodules. They should remain separate so their upstream history
and remotes are not flattened into this parent repository.
ga_engineered is not treated as a remote child repository for the current
upload. It is committed directly into this parent repository so a clone of
GenericAgent_project contains the engineered implementation without an
additional submodule fetch.
Common local verification:
cd ga_engineered
python3 -m json.tool tasks.json >/dev/null
python3 -m compileall -q src tests
cd ui-tui && npm run type-check && npm test
cd ..
SKIP_INSTALL=1 ./scripts/build_tui.shSee ga_engineered/tasks/TASK_REPORT.md
for task-by-task verification notes and known local environment gaps.