Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
46 lines (33 loc) · 1.61 KB

CONTRIBUTING.md

File metadata and controls

46 lines (33 loc) · 1.61 KB
Raw

Contributing

Thanks for helping improve Agent Console.

This repo is intentionally small: one Python file, one single-page UI and a focused free-tier scope. Contributions should make the single-agent console easier to run, safer to publish or clearer to adapt.

Good contributions

  • setup and documentation improvements
  • bug fixes for existing endpoints or browser behavior
  • safer defaults and clearer redaction
  • example fixtures that do not expose private data
  • small read-only status panels that fit the single-agent scope
  • accessibility fixes that preserve the existing design

Out of scope

Please do not add these to the free tier:

  • plugin marketplace
  • paid Perseon Mission Control Full Stack features
  • broad multi-agent orchestration
  • write controls for files, cron jobs or skills
  • private Perseon agents, persona canon, internal prompts, memories, logs or credentials
  • large UI redesigns

Local verification

Run at minimum:

python3 -m py_compile agent_console.py
AGENT_CONSOLE_HOST=127.0.0.1 AGENT_CONSOLE_PORT=4200 python3 agent_console.py
curl -s http://127.0.0.1:4200/health
curl -s http://127.0.0.1:4200/agent-config

If you change browser behavior, also open the page and check the browser console for JavaScript errors.

Pull request checklist

  • The change is small and focused.
  • The visual design is preserved unless the PR clearly explains a tiny fix.
  • No secrets, logs, local state, screenshots with private data or certificates are included.
  • README or docs are updated when behavior changes.
  • Verification commands and results are included in the PR description.