Vizr

Local web app that schedules recurring agent tasks based on a Codex/Claude Code directory + prompt, and exposes job/run history with output assets.

Quick start (dev)

• Copy .env.example to .env and confirm PORT=42424 and CORS_ALLOW_ORIGINS.
• Install backend deps: npm run setup
• Start backend: npm run start
• Start frontend (Vite): npm install then npm run dev (defaults to http://localhost:5173).
• Health check: curl http://localhost:42424/health

System dependencies

• script (provided by util-linux) for running Codex in a pseudo-tty. Install on Fedora/RHEL-like: sudo dnf install util-linux.
• OPENAI_API_KEY set in your environment for Vizr Agent (OpenAI Agent SDK).
• Optional: OPENAI_MODEL (default gpt-4.1-mini).

Backend overview

• Node service in server/index.js with file-backed storage under data/.
• Assets stored in data/assets/<jobId>/<runId>/.
• OpenAI API key can be saved in data/settings.json via the Settings modal.
• CORS allowlist configured via CORS_ALLOW_ORIGINS (comma-separated).
• Vizr Agent uses OpenAI Responses API with code_interpreter and web_search tools.

systemd user service (Fedora/RHEL-like)

• Template unit: systemd/vizr.service
• Install: cp systemd/vizr.service ~/.config/systemd/user/vizr.service
• Enable: systemctl --user enable --now vizr.service

API sketch

• GET /health
• GET /jobs
• POST /jobs
• GET /jobs/:id
• GET /jobs/:id/runs
• POST /jobs/:id/run
• GET /jobs/:jobId/runs/:runId/assets/:assetId
• GET /jobs/:jobId/runs/:runId/assets/:assetId/download