Runtime-ready coding operations

Code Assist for safe, reviewable repository changes.

Run focused coding tasks with managed checkout, branch guardrails, production checks, change logs, notifications, Docker Desktop simulation, and an optional operator UI.

agennext-code-assist run \
  "Make this repo production-ready" \
  --target-url <repo-or-issue-url> \
  --work-branch code-assist/issue-1 \
  --check production \
  --json

Implemented capabilities

Built for controlled code changes

Managed checkout

Resolve target repositories and GitHub URLs into safe work branches.

Guardrails

No commit, push, PR, merge, or notification without explicit authorization.

Production checks

Run dependency, typecheck, lint, unit, integration, smoke, Docker, and publishability checks.

Change logs

Generate per-run logs with objective, changed files, checks, anomalies, and next steps.

Notifications

Optional Slack, generic webhook, and SMTP run notifications.

Operator UI

Optional Next.js chat UI for target inputs, check selection, guardrails, and review.

Quickstart

Run locally or in Docker Desktop

Start with the Python CLI, run the FastAPI backend, or launch the local production simulation with Docker Desktop.

git clone https://github.com/AGenNext/Code-Assist.git
cd Code-Assist
python3.12 -m venv .venv
.venv/bin/pip install -e .
cp .env.example .env
agennext-code-assist serve --host 127.0.0.1 --port 8090
bash scripts/simulate-production.sh up

Architecture

Orchestrator-first design

01

Target resolution

Resolve local repos or GitHub URLs into a controlled work branch and hydrated task context.

02

Focused code pass

Run Aider-backed edits with selected files, skills, memory, and bounded knowledge context.

03

Validation

Run checks, anomaly detection, Docker simulation, and optional notification delivery.

04

Future gates

Planned gate microservices will enforce audit traces, update modes, security scans, cloud RAG, and policy decisions.

Tracked next

Planned hardening work

These items are tracked as future planned work after the current implemented release.