robert-github-agent 0.1.0b1__tar.gz → 0.1.0b2__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.github/workflows/ci.yml +10 -8
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.github/workflows/dco.yml +1 -1
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.github/workflows/release.yml +4 -4
- robert_github_agent-0.1.0b2/CHANGELOG.md +17 -0
- robert_github_agent-0.1.0b2/PKG-INFO +178 -0
- robert_github_agent-0.1.0b1/README_ZH.md → robert_github_agent-0.1.0b2/README.md +30 -58
- robert_github_agent-0.1.0b1/README.md → robert_github_agent-0.1.0b2/README_EN.md +18 -2
- robert_github_agent-0.1.0b2/docs/agent-install.md +183 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/docs/concepts.md +1 -2
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/docs/development.md +120 -33
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/docs/guides.md +1 -1
- robert_github_agent-0.1.0b2/docs/human-install.md +42 -0
- robert_github_agent-0.1.0b2/docs/imgs/openclaw-robert-status.png +0 -0
- robert_github_agent-0.1.0b2/docs/imgs/webui-task-board.png +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/docs/reference.md +79 -3
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/pyproject.toml +6 -2
- robert_github_agent-0.1.0b2/src/robert_agent/__init__.py +1 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/cli/main.py +26 -4
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/dispatch.py +16 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/init_config.py +13 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/integrations/openclaw.py +128 -1
- robert_github_agent-0.1.0b2/src/robert_agent/resources/config.example.yml +33 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/schemas/config.schema.json +17 -0
- robert_github_agent-0.1.0b2/src/robert_agent/service.py +384 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/validate_config.py +45 -18
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_cli.py +60 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_config_and_schema.py +21 -3
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_daemon.py +9 -9
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_distribution.py +5 -2
- robert_github_agent-0.1.0b2/tests/test_docs.py +82 -0
- robert_github_agent-0.1.0b2/tests/test_openclaw.py +83 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_run_once.py +22 -4
- robert_github_agent-0.1.0b2/tests/test_service.py +145 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_worker_adapter_config.py +27 -0
- robert_github_agent-0.1.0b1/CHANGELOG.md +0 -9
- robert_github_agent-0.1.0b1/PKG-INFO +0 -217
- robert_github_agent-0.1.0b1/src/robert_agent/__init__.py +0 -1
- robert_github_agent-0.1.0b1/src/robert_agent/resources/config.example.yml +0 -20
- robert_github_agent-0.1.0b1/src/robert_agent/service.py +0 -161
- robert_github_agent-0.1.0b1/tests/test_docs.py +0 -43
- robert_github_agent-0.1.0b1/tests/test_openclaw.py +0 -19
- robert_github_agent-0.1.0b1/tests/test_service.py +0 -29
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.github/CODEOWNERS +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.github/ISSUE_TEMPLATE/bug.yml +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.github/ISSUE_TEMPLATE/config.yml +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.github/ISSUE_TEMPLATE/documentation.yml +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.github/ISSUE_TEMPLATE/feature.yml +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.github/PULL_REQUEST_TEMPLATE.md +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.github/dependabot.yml +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/.gitignore +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/AGENTS.md +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/COMMUNITY.md +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/LICENSE +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/acceptance.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/acceptance_suite.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/audit_result.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/authorize.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/board.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/chat_status.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/cli/__init__.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/cli/exit_codes.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/cli/output.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/common.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/controlled_e2e_acceptance.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/daemon.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/daemon_state.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/diagnostics.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/discover.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/doctor.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/github_api.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/integrations/__init__.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/live_discovery_acceptance.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/live_worker_acceptance.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/live_worktree_acceptance.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/loop_engine.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/memory_curator.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/migrate.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/notify.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/paths.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/production_write_canary.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/project_memory.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/publish.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/publish_dedupe_acceptance.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/redaction.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/render_prompt.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resource_files.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/__init__.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/acceptance-matrix.md +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/classifier.md +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/command-matrix.md +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/db/migrations/001_legacy_dd_to_robert.sql +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/db/schema.sql +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/failure-modes.md +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/fixtures/actor-permission.json +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/fixtures/discovery.json +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/fixtures/redaction.json +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/fixtures/review-followup.json +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/fixtures/worker-results.json +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/fixtures/workstreams.json +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/github-events.md +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/kanban-control.md +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/redaction.md +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/result-contract.md +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/routes.yml +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/schemas/event.schema.json +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/schemas/result.schema.json +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/schemas/route.schema.json +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/schemas/snapshot.schema.json +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/schemas/task.schema.json +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/trust-model.md +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/worker-prompt.md +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/worker-protocol.md +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/workflow.yml +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/resources/workstream-model.md +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/route.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/route_config.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/run_once.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/runtime_knowledge.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/skills.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/status.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/storage.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/summarize.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/supervise.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/usage.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/wakeup.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/web.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/web_assets/board.css +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/web_assets/board.html +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/web_assets/board.js +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/web_assets/github-shell.css +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/web_assets/index.html +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/web_assets/operations.css +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/web_assets/workbench.css +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/web_assets/workbench.js +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/work_items.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/workbench.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker/__init__.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker/heartbeat.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker/result.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker/snapshot.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker_adapters/__init__.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker_adapters/cbc.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker_adapters/codex.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker_adapters/command.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker_adapters/tcodex.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker_heartbeat.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker_result.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worker_snapshot.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/workstream.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/src/robert_agent/worktree.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/__init__.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/support.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_acceptance_suite.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_board.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_board_control_integration.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_controlled_e2e_acceptance.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_diagnostics.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_discovery_authorization.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_github_event_matrix.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_init_and_doctor.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_live_discovery_acceptance.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_live_worker_acceptance.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_live_worktree_acceptance.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_loop_engine.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_migration.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_operational_commands.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_package_layout.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_paths.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_production_write_canary.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_project_memory.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_public_surface.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_publish_dedupe_acceptance.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_redaction.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_route_config.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_routing.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_runtime_knowledge.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_skills.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_web_security.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_work_items.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_workbench.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_worker_protocol.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_workflow_matrix.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_workspace_resolution.py +0 -0
- {robert_github_agent-0.1.0b1 → robert_github_agent-0.1.0b2}/tests/test_workstreams.py +0 -0
|
@@ -17,8 +17,8 @@ jobs:
|
|
|
17
17
|
python: ["3.10", "3.11", "3.12", "3.13", "3.14"]
|
|
18
18
|
runs-on: ${{ matrix.os }}
|
|
19
19
|
steps:
|
|
20
|
-
- uses: actions/checkout@
|
|
21
|
-
- uses: actions/setup-python@
|
|
20
|
+
- uses: actions/checkout@v7
|
|
21
|
+
- uses: actions/setup-python@v7
|
|
22
22
|
with:
|
|
23
23
|
python-version: ${{ matrix.python }}
|
|
24
24
|
cache: pip
|
|
@@ -42,8 +42,8 @@ jobs:
|
|
|
42
42
|
wheel-smoke:
|
|
43
43
|
runs-on: ubuntu-latest
|
|
44
44
|
steps:
|
|
45
|
-
- uses: actions/checkout@
|
|
46
|
-
- uses: actions/setup-python@
|
|
45
|
+
- uses: actions/checkout@v7
|
|
46
|
+
- uses: actions/setup-python@v7
|
|
47
47
|
with:
|
|
48
48
|
python-version: "3.12"
|
|
49
49
|
- run: python -m pip install build
|
|
@@ -56,21 +56,23 @@ jobs:
|
|
|
56
56
|
secret-scan:
|
|
57
57
|
runs-on: ubuntu-latest
|
|
58
58
|
steps:
|
|
59
|
-
- uses: actions/checkout@
|
|
59
|
+
- uses: actions/checkout@v7
|
|
60
60
|
with:
|
|
61
61
|
fetch-depth: 0
|
|
62
|
-
- uses: gitleaks/gitleaks-action@
|
|
62
|
+
- uses: gitleaks/gitleaks-action@v3
|
|
63
|
+
env:
|
|
64
|
+
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
|
63
65
|
|
|
64
66
|
docs-links:
|
|
65
67
|
runs-on: ubuntu-latest
|
|
66
68
|
steps:
|
|
67
|
-
- uses: actions/checkout@
|
|
69
|
+
- uses: actions/checkout@v7
|
|
68
70
|
- uses: lycheeverse/lychee-action@v2
|
|
69
71
|
with:
|
|
70
72
|
failIfEmpty: false
|
|
71
73
|
args: >-
|
|
72
74
|
--no-progress
|
|
73
75
|
README.md
|
|
74
|
-
|
|
76
|
+
README_EN.md
|
|
75
77
|
COMMUNITY.md
|
|
76
78
|
docs
|
|
@@ -15,8 +15,8 @@ jobs:
|
|
|
15
15
|
runs-on: ubuntu-latest
|
|
16
16
|
environment: pypi
|
|
17
17
|
steps:
|
|
18
|
-
- uses: actions/checkout@
|
|
19
|
-
- uses: actions/setup-python@
|
|
18
|
+
- uses: actions/checkout@v7
|
|
19
|
+
- uses: actions/setup-python@v7
|
|
20
20
|
with:
|
|
21
21
|
python-version: "3.12"
|
|
22
22
|
- run: python -m pip install --upgrade pip
|
|
@@ -24,11 +24,11 @@ jobs:
|
|
|
24
24
|
- run: python -m pip install build
|
|
25
25
|
- run: python -B -m unittest discover -s tests
|
|
26
26
|
- run: python -m build
|
|
27
|
-
- uses: actions/attest-build-provenance@
|
|
27
|
+
- uses: actions/attest-build-provenance@v4
|
|
28
28
|
with:
|
|
29
29
|
subject-path: "dist/*"
|
|
30
30
|
- uses: pypa/gh-action-pypi-publish@release/v1
|
|
31
|
-
- uses: softprops/action-gh-release@
|
|
31
|
+
- uses: softprops/action-gh-release@v3
|
|
32
32
|
with:
|
|
33
33
|
files: dist/*
|
|
34
34
|
generate_release_notes: true
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 0.1.0b2
|
|
4
|
+
|
|
5
|
+
- Add a Supervisor fallback for Linux hosts without user systemd, including service status and control support.
|
|
6
|
+
- Improve OpenClaw plugin installation diagnostics and verify installed commands expose Robert capabilities.
|
|
7
|
+
- Nest daemon configuration settings in the generated config and schema.
|
|
8
|
+
- Fix GitHub Actions release, DCO, gitleaks, documentation-link, and worker-dispatch checks.
|
|
9
|
+
- Refresh installation documentation, README copy, and Web UI/OpenClaw screenshots.
|
|
10
|
+
|
|
11
|
+
## 0.1.0b1
|
|
12
|
+
|
|
13
|
+
- Initial public beta of Robert.
|
|
14
|
+
- Standalone Python package and `robert` CLI.
|
|
15
|
+
- Multi-repository trusted GitHub workstreams.
|
|
16
|
+
- Configurable worker adapters and route skills.
|
|
17
|
+
- Native user services, local web UI, and optional OpenClaw commands.
|
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: robert-github-agent
|
|
3
|
+
Version: 0.1.0b2
|
|
4
|
+
Summary: An AI teammate that takes care of your GitHub work.
|
|
5
|
+
Project-URL: Homepage, https://github.com/wklken/robert
|
|
6
|
+
Project-URL: Documentation, https://github.com/wklken/robert/tree/main/docs
|
|
7
|
+
Project-URL: Issues, https://github.com/wklken/robert/issues
|
|
8
|
+
Author: Robert contributors
|
|
9
|
+
License-Expression: Apache-2.0
|
|
10
|
+
License-File: LICENSE
|
|
11
|
+
Classifier: Development Status :: 4 - Beta
|
|
12
|
+
Classifier: Environment :: Console
|
|
13
|
+
Classifier: License :: OSI Approved :: Apache Software License
|
|
14
|
+
Classifier: Operating System :: MacOS
|
|
15
|
+
Classifier: Operating System :: POSIX :: Linux
|
|
16
|
+
Classifier: Programming Language :: Python :: 3
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
20
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
21
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
22
|
+
Classifier: Topic :: Software Development
|
|
23
|
+
Requires-Python: >=3.10
|
|
24
|
+
Requires-Dist: pyyaml<7,>=6.0
|
|
25
|
+
Requires-Dist: supervisor<5,>=4.2
|
|
26
|
+
Provides-Extra: dev
|
|
27
|
+
Requires-Dist: build; extra == 'dev'
|
|
28
|
+
Requires-Dist: mypy; extra == 'dev'
|
|
29
|
+
Requires-Dist: pip-audit; extra == 'dev'
|
|
30
|
+
Requires-Dist: ruff; extra == 'dev'
|
|
31
|
+
Requires-Dist: tomli; (python_version < '3.11') and extra == 'dev'
|
|
32
|
+
Requires-Dist: twine; extra == 'dev'
|
|
33
|
+
Requires-Dist: types-pyyaml; extra == 'dev'
|
|
34
|
+
Description-Content-Type: text/markdown
|
|
35
|
+
|
|
36
|
+
# Robert
|
|
37
|
+
|
|
38
|
+
[English](README_EN.md) | [简体中文](README.md)
|
|
39
|
+
|
|
40
|
+
**Your Repo Teammate**
|
|
41
|
+
|
|
42
|
+
An AI teammate that takes care of your GitHub work.
|
|
43
|
+
|
|
44
|
+
Robert 是一个自托管的 GitHub 队友。它把可信的 Issue、提及、指派、评审和
|
|
45
|
+
后续评论转换为受控的编码代理任务,并通过 Git worktree、审计门禁和 SQLite
|
|
46
|
+
持久状态保证无人值守运行仍然可检查、可恢复。Robert 是运行在本机的 GitHub
|
|
47
|
+
协作控制面:它发现事件、校验信任关系、选择路由和 Worker、监督执行、审计
|
|
48
|
+
计划中的 GitHub 动作,并只发布路由允许的动作。
|
|
49
|
+
|
|
50
|
+
编码代理本身不能解决授权、并发、去重、失败恢复和证据留存。Robert 将这些
|
|
51
|
+
约束做成稳定协议,不需要 GitHub App,也不需要托管控制服务。Robert
|
|
52
|
+
`0.1.0b2` 是公开 Beta,当前只使用轮询获取 GitHub 事件,稳定版之前接口仍
|
|
53
|
+
可能调整。
|
|
54
|
+
|
|
55
|
+
## 核心能力
|
|
56
|
+
|
|
57
|
+
- 处理可信的 Issue、PR、评审、指派和提及。
|
|
58
|
+
- 使用 SQLite 管理多仓库工作流;每个仓库有独立 checkout、worktree 根目录、
|
|
59
|
+
可信 Actor、并发限制和路由覆盖。
|
|
60
|
+
- 内置 `codex`、`tcodex`、`cbc` 和通用 `command` Worker 适配器。
|
|
61
|
+
- 按路由配置 Worker、必需 Skill 和推荐 Skill;缺少必需 Skill 时会在创建
|
|
62
|
+
worktree 和启动 Worker 前阻止任务。
|
|
63
|
+
- 使用隔离的 Git worktree 进行分析、实现和源码评审。
|
|
64
|
+
- 支持 systemd 用户服务和 macOS LaunchAgent。
|
|
65
|
+
- 默认只读的本地 Web UI。
|
|
66
|
+
- 可选的 OpenClaw 只读聊天命令。
|
|
67
|
+
|
|
68
|
+
## 工作流程
|
|
69
|
+
|
|
70
|
+
```mermaid
|
|
71
|
+
flowchart LR
|
|
72
|
+
A[通过 gh 轮询 GitHub] --> B[规范化并校验授权]
|
|
73
|
+
B --> C[创建或恢复 workstream]
|
|
74
|
+
C --> D[选择路由和 Skill]
|
|
75
|
+
D --> E[准备隔离 workspace]
|
|
76
|
+
E --> F[运行配置的 Worker]
|
|
77
|
+
F --> G[审计结构化结果]
|
|
78
|
+
G -->|通过| H[去重并发布]
|
|
79
|
+
G -->|阻止| I[保存失败证据]
|
|
80
|
+
H --> J[(SQLite 状态)]
|
|
81
|
+
I --> J
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
Robert 使用已认证的 `gh` CLI 轮询 GitHub,规范化事件,应用仓库级信任规则,
|
|
85
|
+
创建或恢复 workstream,准备任务目录,启动本地 Worker,审计结构化结果,并
|
|
86
|
+
在发布前执行去重。
|
|
87
|
+
|
|
88
|
+
## 环境要求
|
|
89
|
+
|
|
90
|
+
- Linux 或 macOS;Windows 通过 WSL 使用。
|
|
91
|
+
- Python 3.10 或更高版本。
|
|
92
|
+
- Git 和已登录的 GitHub CLI。
|
|
93
|
+
- 至少一个本地 Worker 命令。
|
|
94
|
+
- 推荐使用 `pipx` 安装。
|
|
95
|
+
|
|
96
|
+
## 使用编码 Agent 安装
|
|
97
|
+
|
|
98
|
+
把下面的提示词复制给 Codex、Claude Code 或其他终端编码 Agent:
|
|
99
|
+
|
|
100
|
+
```text
|
|
101
|
+
Install and fully configure Robert on this machine by following:
|
|
102
|
+
https://github.com/wklken/Robert/blob/main/docs/agent-install.md
|
|
103
|
+
|
|
104
|
+
Read the entire guide before executing. Ask me for required values and for
|
|
105
|
+
confirmation wherever the guide requires it.
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
## 配置
|
|
109
|
+
|
|
110
|
+
Robert 使用带版本号的 YAML。配置包括 GitHub 账号、Worker、Skill 搜索路径、
|
|
111
|
+
路由覆盖和一个或多个本地仓库。详见
|
|
112
|
+
[docs/reference.md](docs/reference.md#configuration)。
|
|
113
|
+
|
|
114
|
+
## 守护进程
|
|
115
|
+
|
|
116
|
+
```bash
|
|
117
|
+
robert service install
|
|
118
|
+
robert service start
|
|
119
|
+
robert service status
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
无人值守运行使用 systemd 用户服务或 launchd。前台调试使用
|
|
123
|
+
`robert daemon run`。
|
|
124
|
+
|
|
125
|
+
## 本地 Web UI
|
|
126
|
+
|
|
127
|
+

|
|
128
|
+
|
|
129
|
+
```bash
|
|
130
|
+
robert web run
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
默认模式只读且仅监听本机。写入模式必须显式开启:
|
|
134
|
+
|
|
135
|
+
```bash
|
|
136
|
+
robert web run --writable --operator "$USER"
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
非回环地址还必须使用 `--allow-remote`,并部署经过认证的反向代理。
|
|
140
|
+
|
|
141
|
+
## OpenClaw 集成
|
|
142
|
+
|
|
143
|
+

|
|
144
|
+
|
|
145
|
+
```bash
|
|
146
|
+
robert openclaw install
|
|
147
|
+
robert openclaw status
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
插件只提供 Robert 状态、任务、运行和产物查询,不会启动 Robert,也不会创建
|
|
151
|
+
定时任务。
|
|
152
|
+
|
|
153
|
+
## 故障排查
|
|
154
|
+
|
|
155
|
+
先运行 `robert doctor --output json` 和 `robert service status`。需要提供诊断
|
|
156
|
+
信息时,生成经过脱敏的压缩包:
|
|
157
|
+
|
|
158
|
+
```bash
|
|
159
|
+
robert diagnostics export --output robert-diagnostics.zip
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
不要在公开 Issue 中上传凭证或私有仓库内容。
|
|
163
|
+
|
|
164
|
+
## 参与贡献
|
|
165
|
+
|
|
166
|
+
阅读 [COMMUNITY.md](COMMUNITY.md),执行其中的验证命令,并使用
|
|
167
|
+
`git commit -s` 签署提交。首个 Beta 使用 DCO,不要求 CLA。
|
|
168
|
+
|
|
169
|
+
## 安全与信任模型
|
|
170
|
+
|
|
171
|
+
GitHub 文本始终按不可信输入处理。只有配置中的可信 Actor 能触发工作。仓库
|
|
172
|
+
覆盖不能改变路由的 GitHub 权限和 workspace 策略。Worker 环境变量采用白名单,
|
|
173
|
+
配置文件不保存 GitHub Token,所有对外文本都经过脱敏和审计。Web UI 默认绑定
|
|
174
|
+
`127.0.0.1`。
|
|
175
|
+
|
|
176
|
+
## 许可证
|
|
177
|
+
|
|
178
|
+
Apache License 2.0,详见 `LICENSE`。
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Robert
|
|
2
2
|
|
|
3
|
-
[English](
|
|
3
|
+
[English](README_EN.md) | [简体中文](README.md)
|
|
4
4
|
|
|
5
5
|
**Your Repo Teammate**
|
|
6
6
|
|
|
@@ -8,28 +8,27 @@ An AI teammate that takes care of your GitHub work.
|
|
|
8
8
|
|
|
9
9
|
Robert 是一个自托管的 GitHub 队友。它把可信的 Issue、提及、指派、评审和
|
|
10
10
|
后续评论转换为受控的编码代理任务,并通过 Git worktree、审计门禁和 SQLite
|
|
11
|
-
持久状态保证无人值守运行仍然可检查、可恢复。
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
Robert 是运行在本机的 GitHub 协作控制面。它发现事件、校验信任关系、选择
|
|
16
|
-
路由和 Worker、监督执行、审计计划中的 GitHub 动作,并只发布路由允许的动作。
|
|
17
|
-
|
|
18
|
-
## 为什么需要 Robert
|
|
11
|
+
持久状态保证无人值守运行仍然可检查、可恢复。Robert 是运行在本机的 GitHub
|
|
12
|
+
协作控制面:它发现事件、校验信任关系、选择路由和 Worker、监督执行、审计
|
|
13
|
+
计划中的 GitHub 动作,并只发布路由允许的动作。
|
|
19
14
|
|
|
20
15
|
编码代理本身不能解决授权、并发、去重、失败恢复和证据留存。Robert 将这些
|
|
21
|
-
约束做成稳定协议,不需要 GitHub App,也不需要托管控制服务。
|
|
16
|
+
约束做成稳定协议,不需要 GitHub App,也不需要托管控制服务。Robert
|
|
17
|
+
`0.1.0b2` 是公开 Beta,当前只使用轮询获取 GitHub 事件,稳定版之前接口仍
|
|
18
|
+
可能调整。
|
|
22
19
|
|
|
23
20
|
## 核心能力
|
|
24
21
|
|
|
25
22
|
- 处理可信的 Issue、PR、评审、指派和提及。
|
|
26
|
-
- 使用 SQLite
|
|
27
|
-
|
|
23
|
+
- 使用 SQLite 管理多仓库工作流;每个仓库有独立 checkout、worktree 根目录、
|
|
24
|
+
可信 Actor、并发限制和路由覆盖。
|
|
25
|
+
- 内置 `codex`、`tcodex`、`cbc` 和通用 `command` Worker 适配器。
|
|
26
|
+
- 按路由配置 Worker、必需 Skill 和推荐 Skill;缺少必需 Skill 时会在创建
|
|
27
|
+
worktree 和启动 Worker 前阻止任务。
|
|
28
28
|
- 使用隔离的 Git worktree 进行分析、实现和源码评审。
|
|
29
29
|
- 支持 systemd 用户服务和 macOS LaunchAgent。
|
|
30
30
|
- 默认只读的本地 Web UI。
|
|
31
31
|
- 可选的 OpenClaw 只读聊天命令。
|
|
32
|
-
- 安全迁移原 `dd-github-agent` 目录中的配置和数据库。
|
|
33
32
|
|
|
34
33
|
## 工作流程
|
|
35
34
|
|
|
@@ -51,13 +50,6 @@ Robert 使用已认证的 `gh` CLI 轮询 GitHub,规范化事件,应用仓
|
|
|
51
50
|
创建或恢复 workstream,准备任务目录,启动本地 Worker,审计结构化结果,并
|
|
52
51
|
在发布前执行去重。
|
|
53
52
|
|
|
54
|
-
## 安全与信任模型
|
|
55
|
-
|
|
56
|
-
GitHub 文本始终按不可信输入处理。只有配置中的可信 Actor 能触发工作。仓库
|
|
57
|
-
覆盖不能改变路由的 GitHub 权限和 workspace 策略。Worker 环境变量采用白名单,
|
|
58
|
-
配置文件不保存 GitHub Token,所有对外文本都经过脱敏和审计。Web UI 默认绑定
|
|
59
|
-
`127.0.0.1`。
|
|
60
|
-
|
|
61
53
|
## 环境要求
|
|
62
54
|
|
|
63
55
|
- Linux 或 macOS;Windows 通过 WSL 使用。
|
|
@@ -66,19 +58,17 @@ GitHub 文本始终按不可信输入处理。只有配置中的可信 Actor 能
|
|
|
66
58
|
- 至少一个本地 Worker 命令。
|
|
67
59
|
- 推荐使用 `pipx` 安装。
|
|
68
60
|
|
|
69
|
-
##
|
|
61
|
+
## 使用编码 Agent 安装
|
|
70
62
|
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
robert service install
|
|
77
|
-
robert service start
|
|
78
|
-
```
|
|
63
|
+
把下面的提示词复制给 Codex、Claude Code 或其他终端编码 Agent:
|
|
64
|
+
|
|
65
|
+
```text
|
|
66
|
+
Install and fully configure Robert on this machine by following:
|
|
67
|
+
https://github.com/wklken/Robert/blob/main/docs/agent-install.md
|
|
79
68
|
|
|
80
|
-
|
|
81
|
-
|
|
69
|
+
Read the entire guide before executing. Ask me for required values and for
|
|
70
|
+
confirmation wherever the guide requires it.
|
|
71
|
+
```
|
|
82
72
|
|
|
83
73
|
## 配置
|
|
84
74
|
|
|
@@ -86,21 +76,6 @@ Robert 使用带版本号的 YAML。配置包括 GitHub 账号、Worker、Skill
|
|
|
86
76
|
路由覆盖和一个或多个本地仓库。详见
|
|
87
77
|
[docs/reference.md](docs/reference.md#configuration)。
|
|
88
78
|
|
|
89
|
-
## Worker 适配器
|
|
90
|
-
|
|
91
|
-
内置 `codex`、`tcodex`、`cbc` 和通用 `command` 适配器。Worker 定义包含命令、
|
|
92
|
-
默认模型、推理强度、超时、输入方式和环境变量白名单。
|
|
93
|
-
|
|
94
|
-
## 路由技能配置
|
|
95
|
-
|
|
96
|
-
路由可以配置必需 Skill 和推荐 Skill。缺少必需 Skill 时,任务会在创建
|
|
97
|
-
worktree 和启动 Worker 之前被阻止;缺少推荐 Skill 只会产生诊断提示。
|
|
98
|
-
|
|
99
|
-
## 多仓库
|
|
100
|
-
|
|
101
|
-
每个仓库拥有独立 checkout、worktree 根目录、可信 Actor、并发限制和路由覆盖。
|
|
102
|
-
单个仓库失败不会阻塞同一轮中的其他仓库。
|
|
103
|
-
|
|
104
79
|
## 守护进程
|
|
105
80
|
|
|
106
81
|
```bash
|
|
@@ -114,6 +89,8 @@ robert service status
|
|
|
114
89
|
|
|
115
90
|
## 本地 Web UI
|
|
116
91
|
|
|
92
|
+

|
|
93
|
+
|
|
117
94
|
```bash
|
|
118
95
|
robert web run
|
|
119
96
|
```
|
|
@@ -128,6 +105,8 @@ robert web run --writable --operator "$USER"
|
|
|
128
105
|
|
|
129
106
|
## OpenClaw 集成
|
|
130
107
|
|
|
108
|
+

|
|
109
|
+
|
|
131
110
|
```bash
|
|
132
111
|
robert openclaw install
|
|
133
112
|
robert openclaw status
|
|
@@ -136,15 +115,6 @@ robert openclaw status
|
|
|
136
115
|
插件只提供 Robert 状态、任务、运行和产物查询,不会启动 Robert,也不会创建
|
|
137
116
|
定时任务。
|
|
138
117
|
|
|
139
|
-
## 迁移
|
|
140
|
-
|
|
141
|
-
```bash
|
|
142
|
-
robert migrate dd-github-agent --dry-run
|
|
143
|
-
robert migrate dd-github-agent
|
|
144
|
-
```
|
|
145
|
-
|
|
146
|
-
迁移会保留独立备份,并继续识别旧的去重标记。
|
|
147
|
-
|
|
148
118
|
## 故障排查
|
|
149
119
|
|
|
150
120
|
先运行 `robert doctor --output json` 和 `robert service status`。需要提供诊断
|
|
@@ -161,10 +131,12 @@ robert diagnostics export --output robert-diagnostics.zip
|
|
|
161
131
|
阅读 [COMMUNITY.md](COMMUNITY.md),执行其中的验证命令,并使用
|
|
162
132
|
`git commit -s` 签署提交。首个 Beta 使用 DCO,不要求 CLA。
|
|
163
133
|
|
|
164
|
-
##
|
|
134
|
+
## 安全与信任模型
|
|
165
135
|
|
|
166
|
-
|
|
167
|
-
|
|
136
|
+
GitHub 文本始终按不可信输入处理。只有配置中的可信 Actor 能触发工作。仓库
|
|
137
|
+
覆盖不能改变路由的 GitHub 权限和 workspace 策略。Worker 环境变量采用白名单,
|
|
138
|
+
配置文件不保存 GitHub Token,所有对外文本都经过脱敏和审计。Web UI 默认绑定
|
|
139
|
+
`127.0.0.1`。
|
|
168
140
|
|
|
169
141
|
## 许可证
|
|
170
142
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Robert
|
|
2
2
|
|
|
3
|
-
[English](
|
|
3
|
+
[English](README_EN.md) | [简体中文](README.md)
|
|
4
4
|
|
|
5
5
|
**Your Repo Teammate**
|
|
6
6
|
|
|
@@ -85,6 +85,18 @@ robert service start
|
|
|
85
85
|
The configuration is written to `~/.config/robert/config.yml`. Runtime data is
|
|
86
86
|
stored under `~/.local/share/robert/`.
|
|
87
87
|
|
|
88
|
+
## Install with a Coding Agent
|
|
89
|
+
|
|
90
|
+
Copy this prompt into Codex, Claude Code, or another terminal coding agent:
|
|
91
|
+
|
|
92
|
+
```text
|
|
93
|
+
Install and fully configure Robert on this machine by following:
|
|
94
|
+
https://github.com/wklken/Robert/blob/main/docs/agent-install.md
|
|
95
|
+
|
|
96
|
+
Read the entire guide before executing. Ask me for required values and for
|
|
97
|
+
confirmation wherever the guide requires it.
|
|
98
|
+
```
|
|
99
|
+
|
|
88
100
|
## Configuration
|
|
89
101
|
|
|
90
102
|
Robert uses versioned YAML. Configure the GitHub account, worker definitions,
|
|
@@ -122,6 +134,8 @@ Robert runs in the foreground under systemd user services or launchd. Use
|
|
|
122
134
|
|
|
123
135
|
## Local Web UI
|
|
124
136
|
|
|
137
|
+

|
|
138
|
+
|
|
125
139
|
```bash
|
|
126
140
|
robert web run
|
|
127
141
|
```
|
|
@@ -137,6 +151,8 @@ proxy.
|
|
|
137
151
|
|
|
138
152
|
## OpenClaw
|
|
139
153
|
|
|
154
|
+

|
|
155
|
+
|
|
140
156
|
```bash
|
|
141
157
|
robert openclaw install
|
|
142
158
|
robert openclaw status
|
|
@@ -175,7 +191,7 @@ of Origin and does not require a CLA for the first beta.
|
|
|
175
191
|
|
|
176
192
|
## Project Status
|
|
177
193
|
|
|
178
|
-
Robert `0.1.
|
|
194
|
+
Robert `0.1.0b2` is a public beta. Polling is the only GitHub event transport in
|
|
179
195
|
this release. Interfaces may evolve before the first stable release.
|
|
180
196
|
|
|
181
197
|
## License
|
|
@@ -0,0 +1,183 @@
|
|
|
1
|
+
# Install Robert with a Coding Agent
|
|
2
|
+
|
|
3
|
+
This guide is written for terminal coding agents such as Codex or Claude Code.
|
|
4
|
+
Read the entire guide before executing commands.
|
|
5
|
+
|
|
6
|
+
## Goal
|
|
7
|
+
|
|
8
|
+
- Install `robert-github-agent`.
|
|
9
|
+
- Configure Robert for one existing local GitHub repository.
|
|
10
|
+
- Validate GitHub CLI authentication and the configured worker.
|
|
11
|
+
- Install the native user service.
|
|
12
|
+
- Start unattended operation only after explicit user confirmation.
|
|
13
|
+
|
|
14
|
+
## Safety Rules
|
|
15
|
+
|
|
16
|
+
- Do not print, copy, request, or store GitHub tokens, API keys, cookies, or
|
|
17
|
+
credentials.
|
|
18
|
+
- Robert must use the existing authenticated `gh` CLI session.
|
|
19
|
+
- If `gh auth status` fails, stop and ask the user to run `gh auth login`.
|
|
20
|
+
- Do not modify Robert's source or the target repository's source.
|
|
21
|
+
- Do not create GitHub issues, comments, pull requests, tags, releases, or
|
|
22
|
+
other remote writes during setup.
|
|
23
|
+
- Do not overwrite `~/.config/robert/config.yml` without explicit approval.
|
|
24
|
+
- Do not use `--force` unless the user approves it after reviewing the existing
|
|
25
|
+
configuration.
|
|
26
|
+
- Explain any system-package installation before running it.
|
|
27
|
+
- Show commands before execution and stop on failed verification.
|
|
28
|
+
|
|
29
|
+
## Required Values
|
|
30
|
+
|
|
31
|
+
Determine safely or ask the user for:
|
|
32
|
+
|
|
33
|
+
1. GitHub repository in `owner/name` form.
|
|
34
|
+
2. Absolute path to its existing local Git checkout.
|
|
35
|
+
3. GitHub account Robert runs as and listens for.
|
|
36
|
+
4. Trusted human GitHub actor allowed to trigger Robert.
|
|
37
|
+
5. Worker command or adapter, such as `codex`.
|
|
38
|
+
|
|
39
|
+
Do not assume that the Robert account and trusted human actor are the same
|
|
40
|
+
account.
|
|
41
|
+
|
|
42
|
+
## Setup Procedure
|
|
43
|
+
|
|
44
|
+
### 1. Inspect the Environment
|
|
45
|
+
|
|
46
|
+
Detect Linux, macOS, or WSL. Check:
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
python3 --version
|
|
50
|
+
git --version
|
|
51
|
+
gh --version
|
|
52
|
+
pipx --version
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
Python must be 3.10 or newer. Also verify the selected worker command:
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
command -v codex
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
Replace `codex` if another worker was selected.
|
|
62
|
+
|
|
63
|
+
### 2. Verify GitHub Authentication
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
gh auth status
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
Do not display credential files or environment variables. If authentication
|
|
70
|
+
fails, stop and ask the user to run:
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
gh auth login
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
### 3. Install pipx When Needed
|
|
77
|
+
|
|
78
|
+
If `pipx` is missing, explain the platform-supported installation command and
|
|
79
|
+
ask before installing a system package. Ensure the pipx binary directory is on
|
|
80
|
+
`PATH`.
|
|
81
|
+
|
|
82
|
+
### 4. Install Robert
|
|
83
|
+
|
|
84
|
+
```bash
|
|
85
|
+
pipx install robert-github-agent
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
If already installed, report the current version and ask before upgrading.
|
|
89
|
+
|
|
90
|
+
```bash
|
|
91
|
+
robert --version
|
|
92
|
+
robert --help
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
### 5. Inspect Existing Configuration
|
|
96
|
+
|
|
97
|
+
```bash
|
|
98
|
+
test -f ~/.config/robert/config.yml
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
If the file exists, do not overwrite it. Run validation and report its current
|
|
102
|
+
state:
|
|
103
|
+
|
|
104
|
+
```bash
|
|
105
|
+
robert config validate \
|
|
106
|
+
--config ~/.config/robert/config.yml \
|
|
107
|
+
--output json
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
Ask before replacing or changing the file.
|
|
111
|
+
|
|
112
|
+
### 6. Create Configuration
|
|
113
|
+
|
|
114
|
+
When no configuration exists, run one correctly quoted command:
|
|
115
|
+
|
|
116
|
+
```bash
|
|
117
|
+
robert init --non-interactive \
|
|
118
|
+
--config ~/.config/robert/config.yml \
|
|
119
|
+
--repo OWNER/REPO \
|
|
120
|
+
--repo-path /absolute/repository/path \
|
|
121
|
+
--worker WORKER \
|
|
122
|
+
--github-account ROBERT_ACCOUNT \
|
|
123
|
+
--trusted-actor TRUSTED_ACTOR
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
Use the values confirmed by the user.
|
|
127
|
+
|
|
128
|
+
### 7. Validate Readiness
|
|
129
|
+
|
|
130
|
+
```bash
|
|
131
|
+
robert config validate \
|
|
132
|
+
--config ~/.config/robert/config.yml \
|
|
133
|
+
--output json
|
|
134
|
+
|
|
135
|
+
robert doctor \
|
|
136
|
+
--config ~/.config/robert/config.yml \
|
|
137
|
+
--output json
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
Do not claim success if a required check failed or was skipped.
|
|
141
|
+
|
|
142
|
+
### 8. Preview and Install the Native Service
|
|
143
|
+
|
|
144
|
+
Preview:
|
|
145
|
+
|
|
146
|
+
```bash
|
|
147
|
+
robert service install \
|
|
148
|
+
--config ~/.config/robert/config.yml \
|
|
149
|
+
--dry-run \
|
|
150
|
+
--output json
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
If validation passed, install:
|
|
154
|
+
|
|
155
|
+
```bash
|
|
156
|
+
robert service install --config ~/.config/robert/config.yml
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
### 9. Confirm Before Starting
|
|
160
|
+
|
|
161
|
+
Explain which repository and GitHub events Robert will monitor. Ask the user
|
|
162
|
+
for explicit confirmation before starting unattended operation.
|
|
163
|
+
|
|
164
|
+
Only after confirmation:
|
|
165
|
+
|
|
166
|
+
```bash
|
|
167
|
+
robert service start
|
|
168
|
+
robert service status --output json
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
## Final Report
|
|
172
|
+
|
|
173
|
+
Report:
|
|
174
|
+
|
|
175
|
+
- Robert version.
|
|
176
|
+
- Configuration path: `~/.config/robert/config.yml`.
|
|
177
|
+
- Runtime data path: `~/.local/share/robert/`.
|
|
178
|
+
- Repository and worker selected.
|
|
179
|
+
- Doctor and service status.
|
|
180
|
+
- Every skipped, blocked, or failed check.
|
|
181
|
+
|
|
182
|
+
Success means Robert is installed, configuration is valid, doctor checks pass,
|
|
183
|
+
the native service is installed, and no GitHub write occurred during setup.
|