noah-code 0.7.0__tar.gz → 1.0.0__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.
Files changed (215) hide show
  1. {noah_code-0.7.0 → noah_code-1.0.0}/PKG-INFO +103 -7
  2. {noah_code-0.7.0 → noah_code-1.0.0}/README.md +101 -6
  3. noah_code-1.0.0/docs/assets/noah-command-menu.svg +160 -0
  4. noah_code-1.0.0/docs/assets/noah-in-action.svg +195 -0
  5. noah_code-1.0.0/docs/assets/noah-permissions.svg +172 -0
  6. noah_code-1.0.0/docs/browser.md +43 -0
  7. {noah_code-0.7.0 → noah_code-1.0.0}/docs/configuration.md +67 -6
  8. noah_code-1.0.0/docs/evaluation-results.json +699 -0
  9. noah_code-1.0.0/docs/evaluation-results.md +206 -0
  10. noah_code-1.0.0/docs/evaluation.md +97 -0
  11. {noah_code-0.7.0 → noah_code-1.0.0}/docs/extensions.md +16 -2
  12. {noah_code-0.7.0 → noah_code-1.0.0}/docs/interactive-reference.md +29 -3
  13. noah_code-1.0.0/docs/lifecycle-hooks.md +41 -0
  14. noah_code-1.0.0/docs/opencode-v2-comparison.md +73 -0
  15. noah_code-1.0.0/docs/persistent-tasks.md +60 -0
  16. noah_code-1.0.0/docs/releases/v0.8.0.md +55 -0
  17. noah_code-1.0.0/docs/releases/v1.0.0.md +74 -0
  18. {noah_code-0.7.0 → noah_code-1.0.0}/docs/reliability.md +32 -3
  19. noah_code-1.0.0/docs/service.md +128 -0
  20. {noah_code-0.7.0 → noah_code-1.0.0}/pyproject.toml +2 -1
  21. noah_code-1.0.0/scripts/capture_readme.py +193 -0
  22. noah_code-1.0.0/scripts/eval_proxy.py +304 -0
  23. noah_code-1.0.0/scripts/evaluate_agents.py +723 -0
  24. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/__init__.py +1 -1
  25. noah_code-1.0.0/src/noah_code/acp.py +493 -0
  26. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/agent.py +175 -38
  27. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/agents.py +45 -2
  28. noah_code-1.0.0/src/noah_code/browser.py +53 -0
  29. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/cli.py +242 -26
  30. noah_code-1.0.0/src/noah_code/codex_account.py +185 -0
  31. noah_code-1.0.0/src/noah_code/codex_client.py +335 -0
  32. noah_code-1.0.0/src/noah_code/codex_rpc.py +304 -0
  33. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/commands.py +9 -0
  34. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/config.py +31 -2
  35. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/credentials.py +17 -0
  36. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/events.py +1 -0
  37. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/hooks.py +64 -4
  38. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/host.py +194 -19
  39. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/llm.py +8 -1
  40. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/llm_replies.py +38 -1
  41. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/macos_sandbox.py +4 -3
  42. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/mcp_setup.py +51 -9
  43. noah_code-1.0.0/src/noah_code/model_streaming.py +275 -0
  44. noah_code-1.0.0/src/noah_code/nooa_compat.py +175 -0
  45. noah_code-1.0.0/src/noah_code/permission_modes.py +38 -0
  46. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/predict.py +6 -0
  47. noah_code-1.0.0/src/noah_code/provider_discovery.py +262 -0
  48. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/providers.py +47 -8
  49. noah_code-1.0.0/src/noah_code/service.py +705 -0
  50. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/steer.py +1 -0
  51. noah_code-1.0.0/src/noah_code/teams.py +159 -0
  52. noah_code-1.0.0/src/noah_code/tool_contracts.py +313 -0
  53. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/tools/memory_tools.py +6 -0
  54. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/tools/plan_tools.py +7 -0
  55. noah_code-1.0.0/src/noah_code/tools/task_tools.py +922 -0
  56. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/tools/workspace_tools.py +124 -47
  57. noah_code-1.0.0/src/noah_code/ui/command_menu.py +83 -0
  58. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/ui/console.py +23 -0
  59. noah_code-1.0.0/src/noah_code/ui/team_screen.py +97 -0
  60. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/ui/textual.css +232 -10
  61. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/ui/textual_app.py +493 -106
  62. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/verification.py +41 -6
  63. noah_code-1.0.0/tests/evals/fixtures/config-merge/config_merge.py +4 -0
  64. noah_code-1.0.0/tests/evals/fixtures/config-merge/tests/acceptance.py +33 -0
  65. noah_code-1.0.0/tests/evals/fixtures/page-ranges/pages.py +9 -0
  66. noah_code-1.0.0/tests/evals/fixtures/page-ranges/tests/acceptance.py +28 -0
  67. noah_code-1.0.0/tests/evals/tasks.json +43 -0
  68. noah_code-1.0.0/tests/evals/test_evaluate_agents.py +259 -0
  69. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_agent_security.py +65 -0
  70. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_agents.py +19 -0
  71. noah_code-1.0.0/tests/test_browser.py +223 -0
  72. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_cache_context.py +2 -2
  73. noah_code-1.0.0/tests/test_cell_literal_preservation.py +108 -0
  74. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_cli.py +4 -1
  75. noah_code-1.0.0/tests/test_codex_account.py +253 -0
  76. noah_code-1.0.0/tests/test_codex_client.py +399 -0
  77. noah_code-1.0.0/tests/test_codex_onboarding_cli.py +245 -0
  78. noah_code-1.0.0/tests/test_codex_onboarding_tui.py +198 -0
  79. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_commands.py +14 -0
  80. noah_code-1.0.0/tests/test_completion_verification.py +185 -0
  81. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_console_ui.py +9 -1
  82. noah_code-1.0.0/tests/test_eval_proxy.py +87 -0
  83. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_host.py +137 -0
  84. noah_code-1.0.0/tests/test_lifecycle_hooks.py +128 -0
  85. noah_code-1.0.0/tests/test_model_streaming.py +518 -0
  86. noah_code-1.0.0/tests/test_permission_modes.py +239 -0
  87. noah_code-1.0.0/tests/test_permission_onboarding_cli.py +178 -0
  88. noah_code-1.0.0/tests/test_permission_onboarding_tui.py +182 -0
  89. noah_code-1.0.0/tests/test_persistent_tasks.py +510 -0
  90. noah_code-1.0.0/tests/test_provider_discovery.py +236 -0
  91. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_providers.py +5 -1
  92. noah_code-1.0.0/tests/test_python_edit_safety.py +243 -0
  93. noah_code-1.0.0/tests/test_service.py +503 -0
  94. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_steer.py +1 -0
  95. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_task_tools.py +37 -0
  96. noah_code-1.0.0/tests/test_teams.py +295 -0
  97. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_textual_tui.py +75 -8
  98. noah_code-1.0.0/tests/test_tool_contracts.py +195 -0
  99. noah_code-1.0.0/tests/test_transport_cli.py +261 -0
  100. noah_code-1.0.0/tests/test_truncated_reply_recovery.py +186 -0
  101. noah_code-1.0.0/tests/test_tui_approvals.py +107 -0
  102. noah_code-1.0.0/tests/test_tui_command_menu.py +96 -0
  103. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_tui_history_dialogs.py +4 -3
  104. noah_code-1.0.0/tests/test_tui_teams.py +162 -0
  105. noah_code-1.0.0/tests/test_verification_completion.py +188 -0
  106. {noah_code-0.7.0 → noah_code-1.0.0}/uv.lock +3 -1
  107. noah_code-0.7.0/docs/assets/noah-in-action.svg +0 -234
  108. noah_code-0.7.0/src/noah_code/nooa_compat.py +0 -75
  109. noah_code-0.7.0/src/noah_code/tools/task_tools.py +0 -475
  110. {noah_code-0.7.0 → noah_code-1.0.0}/.github/workflows/ci.yml +0 -0
  111. {noah_code-0.7.0 → noah_code-1.0.0}/.github/workflows/release.yml +0 -0
  112. {noah_code-0.7.0 → noah_code-1.0.0}/.gitignore +0 -0
  113. {noah_code-0.7.0 → noah_code-1.0.0}/.pre-commit-config.yaml +0 -0
  114. {noah_code-0.7.0 → noah_code-1.0.0}/docs/assets/noah-logo.svg +0 -0
  115. {noah_code-0.7.0 → noah_code-1.0.0}/docs/development.md +0 -0
  116. {noah_code-0.7.0 → noah_code-1.0.0}/docs/releases/v0.1.0.md +0 -0
  117. {noah_code-0.7.0 → noah_code-1.0.0}/docs/releases/v0.1.1.md +0 -0
  118. {noah_code-0.7.0 → noah_code-1.0.0}/docs/releases/v0.2.0.md +0 -0
  119. {noah_code-0.7.0 → noah_code-1.0.0}/docs/releases/v0.2.1.md +0 -0
  120. {noah_code-0.7.0 → noah_code-1.0.0}/docs/releases/v0.2.2.md +0 -0
  121. {noah_code-0.7.0 → noah_code-1.0.0}/docs/releases/v0.2.3.md +0 -0
  122. {noah_code-0.7.0 → noah_code-1.0.0}/docs/releases/v0.2.4.md +0 -0
  123. {noah_code-0.7.0 → noah_code-1.0.0}/docs/releases/v0.3.0.md +0 -0
  124. {noah_code-0.7.0 → noah_code-1.0.0}/docs/releases/v0.4.0.md +0 -0
  125. {noah_code-0.7.0 → noah_code-1.0.0}/docs/releases/v0.4.1.md +0 -0
  126. {noah_code-0.7.0 → noah_code-1.0.0}/docs/releases/v0.5.0.md +0 -0
  127. {noah_code-0.7.0 → noah_code-1.0.0}/docs/releases/v0.5.1.md +0 -0
  128. {noah_code-0.7.0 → noah_code-1.0.0}/docs/releases/v0.6.0.md +0 -0
  129. {noah_code-0.7.0 → noah_code-1.0.0}/docs/releases/v0.7.0.md +0 -0
  130. {noah_code-0.7.0 → noah_code-1.0.0}/docs/security.md +0 -0
  131. {noah_code-0.7.0 → noah_code-1.0.0}/install.sh +0 -0
  132. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/__main__.py +0 -0
  133. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/approvals.py +0 -0
  134. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/budget.py +0 -0
  135. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/checkpoints.py +0 -0
  136. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/composer.py +0 -0
  137. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/custom_commands.py +0 -0
  138. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/event_bridge.py +0 -0
  139. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/github.py +0 -0
  140. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/permissions.py +0 -0
  141. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/project_notes.py +0 -0
  142. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/redaction.py +0 -0
  143. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/runtime_state.py +0 -0
  144. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/secure_files.py +0 -0
  145. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/sessions.py +0 -0
  146. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/skills_setup.py +0 -0
  147. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/snapshots.py +0 -0
  148. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/summarization.py +0 -0
  149. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/telemetry.py +0 -0
  150. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/themes.py +0 -0
  151. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/tool_output.py +0 -0
  152. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/tools/__init__.py +0 -0
  153. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/tools/diff_tools.py +0 -0
  154. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/tools/git_tools.py +0 -0
  155. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/tools/github_tools.py +0 -0
  156. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/tools/lsp_tools.py +0 -0
  157. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/tools/media_tools.py +0 -0
  158. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/tools/process_tools.py +0 -0
  159. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/tools/question_tools.py +0 -0
  160. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/tools/web_tools.py +0 -0
  161. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/ui/__init__.py +0 -0
  162. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/ui/protocol.py +0 -0
  163. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/updates.py +0 -0
  164. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/usage.py +0 -0
  165. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/workspace.py +0 -0
  166. {noah_code-0.7.0 → noah_code-1.0.0}/src/noah_code/worktree.py +0 -0
  167. {noah_code-0.7.0 → noah_code-1.0.0}/tests/conftest.py +0 -0
  168. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_approvals.py +0 -0
  169. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_budget.py +0 -0
  170. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_checkpoints.py +0 -0
  171. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_compaction_eviction.py +0 -0
  172. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_composer.py +0 -0
  173. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_config.py +0 -0
  174. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_credentials.py +0 -0
  175. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_custom_commands.py +0 -0
  176. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_diff_tools.py +0 -0
  177. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_efficiency.py +0 -0
  178. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_event_bridge.py +0 -0
  179. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_event_bridge_and_shell.py +0 -0
  180. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_git_tools.py +0 -0
  181. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_github.py +0 -0
  182. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_hooks.py +0 -0
  183. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_installer.py +0 -0
  184. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_lean_reasoning.py +0 -0
  185. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_llm.py +0 -0
  186. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_llm_replies.py +0 -0
  187. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_lsp_tools.py +0 -0
  188. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_mcp_setup.py +0 -0
  189. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_nooa_migration.py +0 -0
  190. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_permissions.py +0 -0
  191. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_plan_memory_tools.py +0 -0
  192. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_process_tools.py +0 -0
  193. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_project_notes.py +0 -0
  194. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_prompt_scorecard.py +0 -0
  195. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_question_tools.py +0 -0
  196. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_redaction.py +0 -0
  197. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_run_exit.py +0 -0
  198. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_runtime_state.py +0 -0
  199. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_sessions.py +0 -0
  200. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_skills_setup.py +0 -0
  201. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_snapshots.py +0 -0
  202. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_summarization.py +0 -0
  203. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_telemetry.py +0 -0
  204. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_tool_output.py +0 -0
  205. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_tui_composer_queue.py +0 -0
  206. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_tui_editing.py +0 -0
  207. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_tui_layout.py +0 -0
  208. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_tui_review_receipt.py +0 -0
  209. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_updates.py +0 -0
  210. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_verification.py +0 -0
  211. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_verification_tools.py +0 -0
  212. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_wave1_e2e.py +0 -0
  213. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_web_tools.py +0 -0
  214. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_workspace_tools.py +0 -0
  215. {noah_code-0.7.0 → noah_code-1.0.0}/tests/test_worktree.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: noah-code
3
- Version: 0.7.0
3
+ Version: 1.0.0
4
4
  Summary: Noah Code terminal coding agent, built on NVIDIA OO Agents (NOOA)
5
5
  Project-URL: Homepage, https://github.com/skundu42/noah-code
6
6
  Project-URL: Documentation, https://github.com/skundu42/noah-code#readme
@@ -20,6 +20,7 @@ Classifier: Programming Language :: Python :: 3.13
20
20
  Classifier: Topic :: Software Development
21
21
  Requires-Python: <3.14,>=3.12
22
22
  Requires-Dist: click<9.0.0,>=8.1.0
23
+ Requires-Dist: httpx<1.0.0,>=0.28.1
23
24
  Requires-Dist: litellm<1.99.0,>=1.96.0
24
25
  Requires-Dist: nooa-cli==0.0.10
25
26
  Requires-Dist: nooa==0.0.10
@@ -58,12 +59,12 @@ Description-Content-Type: text/markdown
58
59
 
59
60
  </div>
60
61
 
61
- ![Noah Code handling a repository change in its terminal interface](https://raw.githubusercontent.com/skundu42/noah-code/main/docs/assets/noah-in-action.svg)
62
+ ![Noah Code showing a sample build team, conversation, changed files, and review progress](https://raw.githubusercontent.com/skundu42/noah-code/main/docs/assets/noah-in-action.svg)
62
63
 
63
- <p align="center"><sub>The real Textual interface, captured from a deterministic Noah Code session.</sub></p>
64
+ <p align="center"><sub>The real Textual interface with deterministic sample data: a build team hands pagination changes to a read-only reviewer.</sub></p>
64
65
 
65
66
  Noah keeps the conversation central while the sidebar tracks the current action, changed files,
66
- and the active plan. Tool execution stays visible, completed work compacts into
67
+ active plan, and agent handoffs. Tool execution stays visible, completed work compacts into
67
68
  readable records, and every session remains scoped to its repository.
68
69
 
69
70
  Built on the [NVIDIA OO Agents (NOOA)](https://github.com/NVIDIA-NeMo/labs-OO-Agents) runtime.
@@ -85,7 +86,8 @@ noah .
85
86
 
86
87
  Noah is compatible with macOS on Apple Silicon and Intel, plus Linux on arm64 and x86_64.
87
88
 
88
- On the first launch, the TUI walks through provider, API key, model, and reasoning setup. Keys are
89
+ On the first launch, choose Normal, Auto, or YOLO permissions, then a provider, model, and reasoning
90
+ level. Choose **Codex / ChatGPT account** to sign in through your browser, or enter a provider API key. Keys are
89
91
  stored in Noah's private auth file with owner-only permissions; they are never written to project
90
92
  configuration or session history.
91
93
 
@@ -109,6 +111,10 @@ configuration or session history.
109
111
  **plan** mode, with ordered `allow`, `ask`, and `deny` permission rules.
110
112
  - **Extensible workflows.** Add slash commands, opt-in skills, MCP servers, or markdown subagents;
111
113
  attach `@files` and images when the task needs more context.
114
+ - **Coordinated agent teams.** Launch a build, review, or investigation workflow from `F9` or
115
+ `/team`. Specialists hand off findings between phases, and the live work ledger shows progress.
116
+ Teams share session budgets and approvals; read-only work can run concurrently while edits
117
+ use one serialized mutation lane.
112
118
  - **Long-running by design.** Provider retries and configurable fallback models handle transient
113
119
  failures, while workspace leases, bounded artifacts, durable process ownership, and `/health`
114
120
  keep unattended sessions observable.
@@ -125,8 +131,30 @@ Find the cause of the failing parser tests, implement the smallest safe fix, and
125
131
  focused test file.
126
132
  ```
127
133
 
134
+ For work that benefits from several perspectives, give a team one clear objective:
135
+
136
+ ```text
137
+ /team build Add pagination to the search endpoint and cover its edge cases
138
+ /team review Find regressions in the current changes
139
+ /team investigate Trace why login fails after a session expires
140
+ ```
141
+
142
+ Build teams analyze, implement, then review. Review and investigation teams stay read-only,
143
+ including in plan mode. Press `F9` to choose a workflow and edit its objective before sending;
144
+ use `F4` to inspect live team progress. In the console, `/team` lists the workflows.
145
+
128
146
  Useful launch modes:
129
147
 
148
+ First-time interactive setup asks you to choose a permission mode, with **Normal** selected
149
+ by default. Your choice is saved for future launches:
150
+
151
+ - **Normal (recommended):** Ask before commands that need approval; keep protective blocks enabled.
152
+ - **Auto:** Approve routine actions automatically; block interpreters and keep risky-action approvals.
153
+ - **YOLO:** Skip permission checks and approval prompts; use only in isolated, trusted workspaces.
154
+
155
+ This choice is separate from the AI model and build/plan mode. Use `--permissions normal`,
156
+ `--permissions auto`, or `--permissions yolo` to override it for one launch.
157
+
130
158
  ```bash
131
159
  # Open another workspace
132
160
  noah /path/to/repository
@@ -140,8 +168,11 @@ noah run "Explain how authentication is wired" .
140
168
  # Emit one structured result on stdout (progress goes to stderr)
141
169
  noah run --json "Fix the failing unit test" .
142
170
 
143
- # Allow actions that would normally ask; explicit deny rules still apply
144
- noah run --auto "Fix the failing unit test" .
171
+ # Use Normal permissions even if you previously saved YOLO
172
+ noah --permissions normal .
173
+
174
+ # Auto-approve routine actions; interpreter commands remain blocked
175
+ noah --auto .
145
176
 
146
177
  # Resume previous work
147
178
  noah --continue .
@@ -172,6 +203,15 @@ means netcat, `noah` or `noah-code` is recommended.
172
203
 
173
204
  ## Inside the TUI
174
205
 
206
+ The interface keeps frequent actions within reach:
207
+
208
+ - **Readable commands.** Aligned descriptions, muted argument hints, and a subtle selection row
209
+ make slash commands easier to scan. Use arrows, Enter, Tab, or the mouse.
210
+ - **Compact approvals.** See the command and session scope together; expand the reason and rule
211
+ with `D`. Long targets scroll, and approval buttons stay visible in small terminals.
212
+ - **Inspectable teams.** Use `F9` to launch a workflow and `F4` to search assignments, filter work
213
+ needing attention, and read agent results.
214
+
175
215
  Type `/` to search the full command and configuration reference. The most common controls are:
176
216
 
177
217
  | Control | Action |
@@ -204,6 +244,7 @@ Type `/` to search the full command and configuration reference. The most common
204
244
  | `F4` | Open the live agent, terminal, and job ledger |
205
245
  | `F5` | Edit, reorder, resume, or discard queued follow-ups |
206
246
  | `F8` | Show or hide the sidebar |
247
+ | `F9` | Choose a build, review, or investigation team workflow |
207
248
  | `Shift+F7` | Focus or leave the scrollable context rail |
208
249
  | `/model` | Configure a provider or switch the session model |
209
250
  | `/theme` | Choose Atom One Dark, Noah Ocean, Graphite, or High Contrast |
@@ -213,6 +254,7 @@ Type `/` to search the full command and configuration reference. The most common
213
254
  | `/health` | Inspect durable run, job, inbox, event, and artifact state |
214
255
  | `/tokens` | Inspect tokens, cache usage, prefix stability, model wait, and tool output |
215
256
  | `/efficiency` | Switch between `fast`, `balanced`, and `deep` budgets |
257
+ | `/team WORKFLOW OBJECTIVE` | Run a coordinated team, or queue it while another turn is active |
216
258
 
217
259
  On wide terminals, the side rail prioritizes the active operation, delegated agents, named
218
260
  terminals, Git branch and change counts, session, model usage, update state, and plan. Git status is refreshed in the background at turn
@@ -221,6 +263,20 @@ large Noah wordmark until the first prompt, then becomes the conversation and ex
221
263
  The composer footer keeps contextual keys and compact token, cache, and cost telemetry visible at
222
264
  every terminal width where they fit.
223
265
 
266
+ <details>
267
+ <summary>See the command menu and compact approval dialog</summary>
268
+
269
+ ![Noah Code command menu with aligned descriptions and a subtle selection highlight](https://raw.githubusercontent.com/skundu42/noah-code/main/docs/assets/noah-command-menu.svg)
270
+
271
+ *The real command menu, captured with deterministic sample conversation data.*
272
+
273
+ ![Noah Code compact permission dialog showing a shell command, session scope, and approval choices](https://raw.githubusercontent.com/skundu42/noah-code/main/docs/assets/noah-permissions.svg)
274
+
275
+ *The real approval dialog with a sample request. Screenshots illustrate UI behavior, not a live
276
+ provider run or test result.*
277
+
278
+ </details>
279
+
224
280
  ## Sessions and crash recovery
225
281
 
226
282
  Start a new session with `noah .`, resume the latest repository session with
@@ -238,12 +294,23 @@ independent agents need to work concurrently. See
238
294
  [Reliability and long-running sessions](docs/reliability.md) for the recovery model, provider retry
239
295
  controls, quotas, and operational limits.
240
296
 
297
+ Child agents also retain their own conversation snapshots and task IDs. Noah can start,
298
+ inspect, cancel, wait for, and follow up with a child independently. Background writers use
299
+ an optional Git worktree created from committed `HEAD`; local uncommitted changes stay in
300
+ the parent checkout. See [persistent child tasks](docs/persistent-tasks.md).
301
+
241
302
  ## Models and providers
242
303
 
243
304
  Noah supports OpenAI, Anthropic, OpenRouter, NVIDIA, and custom OpenAI-compatible providers. It
244
305
  also works with vLLM, LM Studio, Ollama, Azure OpenAI, Bedrock, Gemini, Groq, Mistral, xAI,
245
306
  DeepSeek, Together AI, and Perplexity.
246
307
 
308
+ You can also connect your **Codex / ChatGPT account** directly in `/model`, without an API key.
309
+ Install the [Codex CLI](https://learn.chatgpt.com/docs/cli) (0.153.4 or newer), then select that
310
+ option or run `noah providers login codex`. On a headless machine, add `--device-code`.
311
+ Noah uses the official Codex app server and a separate Codex-managed login store; account usage
312
+ counts toward your Codex limits. See [account setup](docs/configuration.md#codex--chatgpt-account).
313
+
247
314
  The guided `/model` flow is the easiest way to configure a provider. Environment variables and
248
315
  the CLI remain available for scripts and headless environments:
249
316
 
@@ -254,6 +321,12 @@ noah providers add openai --model MODEL_NAME
254
321
  noah .
255
322
  ```
256
323
 
324
+ Setup offers a searchable model picker, live model discovery for compatible endpoints, and
325
+ manual model entry. Catalog entries whose account access has not been checked are labeled.
326
+ Supported completion clients show incremental generation in a temporary terminal preview;
327
+ the parsed answer is saved when generation completes. Responses clients retain their existing
328
+ completed-response behavior.
329
+
257
330
  `/model MODEL` changes only the current session and remembers that choice when resumed. Use
258
331
  `/model --global MODEL` to set the default for future sessions in every repository.
259
332
 
@@ -268,6 +341,18 @@ See the [provider configuration guide](docs/configuration.md#bring-your-own-api-
268
341
  gateway-specific setup. Provider request deadlines, exponential retry, and ordered fallback models
269
342
  are configured under `[reliability.retries]`.
270
343
 
344
+ ## Integrations
345
+
346
+ `noah serve` exposes authenticated loopback HTTP and resumable event streams; set
347
+ `NOAH_CODE_SERVER_TOKEN` to a random token of at least 32 characters before starting it.
348
+ `noah acp` exposes the same agent host through ACP v1 for compatible editors. See
349
+ [service and ACP](docs/service.md) for endpoints and supported capabilities.
350
+
351
+ `noah browser setup` configures the pinned Playwright MCP browser preset. It uses an isolated
352
+ browser profile and Noah's tool permissions; Node.js and a supported browser are required.
353
+ See [browser tools](docs/browser.md). Trusted user configuration can also run
354
+ [lifecycle hooks](docs/lifecycle-hooks.md) for session, turn, and worktree events.
355
+
271
356
  ## Updates
272
357
 
273
358
  Noah checks PyPI for new versions at most once every 24 hours. New TUI sessions show a temporary
@@ -286,6 +371,13 @@ noah update
286
371
  - [Reliability and long-running sessions](docs/reliability.md)
287
372
  - [Generated-code security](docs/security.md)
288
373
  - [Custom commands, skills, MCP, and tracing](docs/extensions.md)
374
+ - [Persistent child tasks](docs/persistent-tasks.md)
375
+ - [HTTP service and ACP](docs/service.md)
376
+ - [Browser tools](docs/browser.md)
377
+ - [Lifecycle hooks](docs/lifecycle-hooks.md)
378
+ - [Matched agent evaluation](docs/evaluation.md)
379
+ - [Recorded comparison results](docs/evaluation-results.md)
380
+ - [OpenCode v2 comparison and remaining gaps](docs/opencode-v2-comparison.md)
289
381
  - [Development, CI, and releases](docs/development.md)
290
382
  - [Release notes](docs/releases/)
291
383
 
@@ -298,6 +390,10 @@ uv run pytest tests
298
390
  uv build
299
391
  ```
300
392
 
393
+ Regenerate the README screenshots from deterministic sample data with
394
+ `uv run python scripts/capture_readme.py`. This renders the real Textual widgets without making
395
+ provider calls or changing a workspace.
396
+
301
397
  See the [development guide](docs/development.md) for platform checks and the release process.
302
398
 
303
399
  ## License
@@ -12,12 +12,12 @@
12
12
 
13
13
  </div>
14
14
 
15
- ![Noah Code handling a repository change in its terminal interface](https://raw.githubusercontent.com/skundu42/noah-code/main/docs/assets/noah-in-action.svg)
15
+ ![Noah Code showing a sample build team, conversation, changed files, and review progress](https://raw.githubusercontent.com/skundu42/noah-code/main/docs/assets/noah-in-action.svg)
16
16
 
17
- <p align="center"><sub>The real Textual interface, captured from a deterministic Noah Code session.</sub></p>
17
+ <p align="center"><sub>The real Textual interface with deterministic sample data: a build team hands pagination changes to a read-only reviewer.</sub></p>
18
18
 
19
19
  Noah keeps the conversation central while the sidebar tracks the current action, changed files,
20
- and the active plan. Tool execution stays visible, completed work compacts into
20
+ active plan, and agent handoffs. Tool execution stays visible, completed work compacts into
21
21
  readable records, and every session remains scoped to its repository.
22
22
 
23
23
  Built on the [NVIDIA OO Agents (NOOA)](https://github.com/NVIDIA-NeMo/labs-OO-Agents) runtime.
@@ -39,7 +39,8 @@ noah .
39
39
 
40
40
  Noah is compatible with macOS on Apple Silicon and Intel, plus Linux on arm64 and x86_64.
41
41
 
42
- On the first launch, the TUI walks through provider, API key, model, and reasoning setup. Keys are
42
+ On the first launch, choose Normal, Auto, or YOLO permissions, then a provider, model, and reasoning
43
+ level. Choose **Codex / ChatGPT account** to sign in through your browser, or enter a provider API key. Keys are
43
44
  stored in Noah's private auth file with owner-only permissions; they are never written to project
44
45
  configuration or session history.
45
46
 
@@ -63,6 +64,10 @@ configuration or session history.
63
64
  **plan** mode, with ordered `allow`, `ask`, and `deny` permission rules.
64
65
  - **Extensible workflows.** Add slash commands, opt-in skills, MCP servers, or markdown subagents;
65
66
  attach `@files` and images when the task needs more context.
67
+ - **Coordinated agent teams.** Launch a build, review, or investigation workflow from `F9` or
68
+ `/team`. Specialists hand off findings between phases, and the live work ledger shows progress.
69
+ Teams share session budgets and approvals; read-only work can run concurrently while edits
70
+ use one serialized mutation lane.
66
71
  - **Long-running by design.** Provider retries and configurable fallback models handle transient
67
72
  failures, while workspace leases, bounded artifacts, durable process ownership, and `/health`
68
73
  keep unattended sessions observable.
@@ -79,8 +84,30 @@ Find the cause of the failing parser tests, implement the smallest safe fix, and
79
84
  focused test file.
80
85
  ```
81
86
 
87
+ For work that benefits from several perspectives, give a team one clear objective:
88
+
89
+ ```text
90
+ /team build Add pagination to the search endpoint and cover its edge cases
91
+ /team review Find regressions in the current changes
92
+ /team investigate Trace why login fails after a session expires
93
+ ```
94
+
95
+ Build teams analyze, implement, then review. Review and investigation teams stay read-only,
96
+ including in plan mode. Press `F9` to choose a workflow and edit its objective before sending;
97
+ use `F4` to inspect live team progress. In the console, `/team` lists the workflows.
98
+
82
99
  Useful launch modes:
83
100
 
101
+ First-time interactive setup asks you to choose a permission mode, with **Normal** selected
102
+ by default. Your choice is saved for future launches:
103
+
104
+ - **Normal (recommended):** Ask before commands that need approval; keep protective blocks enabled.
105
+ - **Auto:** Approve routine actions automatically; block interpreters and keep risky-action approvals.
106
+ - **YOLO:** Skip permission checks and approval prompts; use only in isolated, trusted workspaces.
107
+
108
+ This choice is separate from the AI model and build/plan mode. Use `--permissions normal`,
109
+ `--permissions auto`, or `--permissions yolo` to override it for one launch.
110
+
84
111
  ```bash
85
112
  # Open another workspace
86
113
  noah /path/to/repository
@@ -94,8 +121,11 @@ noah run "Explain how authentication is wired" .
94
121
  # Emit one structured result on stdout (progress goes to stderr)
95
122
  noah run --json "Fix the failing unit test" .
96
123
 
97
- # Allow actions that would normally ask; explicit deny rules still apply
98
- noah run --auto "Fix the failing unit test" .
124
+ # Use Normal permissions even if you previously saved YOLO
125
+ noah --permissions normal .
126
+
127
+ # Auto-approve routine actions; interpreter commands remain blocked
128
+ noah --auto .
99
129
 
100
130
  # Resume previous work
101
131
  noah --continue .
@@ -126,6 +156,15 @@ means netcat, `noah` or `noah-code` is recommended.
126
156
 
127
157
  ## Inside the TUI
128
158
 
159
+ The interface keeps frequent actions within reach:
160
+
161
+ - **Readable commands.** Aligned descriptions, muted argument hints, and a subtle selection row
162
+ make slash commands easier to scan. Use arrows, Enter, Tab, or the mouse.
163
+ - **Compact approvals.** See the command and session scope together; expand the reason and rule
164
+ with `D`. Long targets scroll, and approval buttons stay visible in small terminals.
165
+ - **Inspectable teams.** Use `F9` to launch a workflow and `F4` to search assignments, filter work
166
+ needing attention, and read agent results.
167
+
129
168
  Type `/` to search the full command and configuration reference. The most common controls are:
130
169
 
131
170
  | Control | Action |
@@ -158,6 +197,7 @@ Type `/` to search the full command and configuration reference. The most common
158
197
  | `F4` | Open the live agent, terminal, and job ledger |
159
198
  | `F5` | Edit, reorder, resume, or discard queued follow-ups |
160
199
  | `F8` | Show or hide the sidebar |
200
+ | `F9` | Choose a build, review, or investigation team workflow |
161
201
  | `Shift+F7` | Focus or leave the scrollable context rail |
162
202
  | `/model` | Configure a provider or switch the session model |
163
203
  | `/theme` | Choose Atom One Dark, Noah Ocean, Graphite, or High Contrast |
@@ -167,6 +207,7 @@ Type `/` to search the full command and configuration reference. The most common
167
207
  | `/health` | Inspect durable run, job, inbox, event, and artifact state |
168
208
  | `/tokens` | Inspect tokens, cache usage, prefix stability, model wait, and tool output |
169
209
  | `/efficiency` | Switch between `fast`, `balanced`, and `deep` budgets |
210
+ | `/team WORKFLOW OBJECTIVE` | Run a coordinated team, or queue it while another turn is active |
170
211
 
171
212
  On wide terminals, the side rail prioritizes the active operation, delegated agents, named
172
213
  terminals, Git branch and change counts, session, model usage, update state, and plan. Git status is refreshed in the background at turn
@@ -175,6 +216,20 @@ large Noah wordmark until the first prompt, then becomes the conversation and ex
175
216
  The composer footer keeps contextual keys and compact token, cache, and cost telemetry visible at
176
217
  every terminal width where they fit.
177
218
 
219
+ <details>
220
+ <summary>See the command menu and compact approval dialog</summary>
221
+
222
+ ![Noah Code command menu with aligned descriptions and a subtle selection highlight](https://raw.githubusercontent.com/skundu42/noah-code/main/docs/assets/noah-command-menu.svg)
223
+
224
+ *The real command menu, captured with deterministic sample conversation data.*
225
+
226
+ ![Noah Code compact permission dialog showing a shell command, session scope, and approval choices](https://raw.githubusercontent.com/skundu42/noah-code/main/docs/assets/noah-permissions.svg)
227
+
228
+ *The real approval dialog with a sample request. Screenshots illustrate UI behavior, not a live
229
+ provider run or test result.*
230
+
231
+ </details>
232
+
178
233
  ## Sessions and crash recovery
179
234
 
180
235
  Start a new session with `noah .`, resume the latest repository session with
@@ -192,12 +247,23 @@ independent agents need to work concurrently. See
192
247
  [Reliability and long-running sessions](docs/reliability.md) for the recovery model, provider retry
193
248
  controls, quotas, and operational limits.
194
249
 
250
+ Child agents also retain their own conversation snapshots and task IDs. Noah can start,
251
+ inspect, cancel, wait for, and follow up with a child independently. Background writers use
252
+ an optional Git worktree created from committed `HEAD`; local uncommitted changes stay in
253
+ the parent checkout. See [persistent child tasks](docs/persistent-tasks.md).
254
+
195
255
  ## Models and providers
196
256
 
197
257
  Noah supports OpenAI, Anthropic, OpenRouter, NVIDIA, and custom OpenAI-compatible providers. It
198
258
  also works with vLLM, LM Studio, Ollama, Azure OpenAI, Bedrock, Gemini, Groq, Mistral, xAI,
199
259
  DeepSeek, Together AI, and Perplexity.
200
260
 
261
+ You can also connect your **Codex / ChatGPT account** directly in `/model`, without an API key.
262
+ Install the [Codex CLI](https://learn.chatgpt.com/docs/cli) (0.153.4 or newer), then select that
263
+ option or run `noah providers login codex`. On a headless machine, add `--device-code`.
264
+ Noah uses the official Codex app server and a separate Codex-managed login store; account usage
265
+ counts toward your Codex limits. See [account setup](docs/configuration.md#codex--chatgpt-account).
266
+
201
267
  The guided `/model` flow is the easiest way to configure a provider. Environment variables and
202
268
  the CLI remain available for scripts and headless environments:
203
269
 
@@ -208,6 +274,12 @@ noah providers add openai --model MODEL_NAME
208
274
  noah .
209
275
  ```
210
276
 
277
+ Setup offers a searchable model picker, live model discovery for compatible endpoints, and
278
+ manual model entry. Catalog entries whose account access has not been checked are labeled.
279
+ Supported completion clients show incremental generation in a temporary terminal preview;
280
+ the parsed answer is saved when generation completes. Responses clients retain their existing
281
+ completed-response behavior.
282
+
211
283
  `/model MODEL` changes only the current session and remembers that choice when resumed. Use
212
284
  `/model --global MODEL` to set the default for future sessions in every repository.
213
285
 
@@ -222,6 +294,18 @@ See the [provider configuration guide](docs/configuration.md#bring-your-own-api-
222
294
  gateway-specific setup. Provider request deadlines, exponential retry, and ordered fallback models
223
295
  are configured under `[reliability.retries]`.
224
296
 
297
+ ## Integrations
298
+
299
+ `noah serve` exposes authenticated loopback HTTP and resumable event streams; set
300
+ `NOAH_CODE_SERVER_TOKEN` to a random token of at least 32 characters before starting it.
301
+ `noah acp` exposes the same agent host through ACP v1 for compatible editors. See
302
+ [service and ACP](docs/service.md) for endpoints and supported capabilities.
303
+
304
+ `noah browser setup` configures the pinned Playwright MCP browser preset. It uses an isolated
305
+ browser profile and Noah's tool permissions; Node.js and a supported browser are required.
306
+ See [browser tools](docs/browser.md). Trusted user configuration can also run
307
+ [lifecycle hooks](docs/lifecycle-hooks.md) for session, turn, and worktree events.
308
+
225
309
  ## Updates
226
310
 
227
311
  Noah checks PyPI for new versions at most once every 24 hours. New TUI sessions show a temporary
@@ -240,6 +324,13 @@ noah update
240
324
  - [Reliability and long-running sessions](docs/reliability.md)
241
325
  - [Generated-code security](docs/security.md)
242
326
  - [Custom commands, skills, MCP, and tracing](docs/extensions.md)
327
+ - [Persistent child tasks](docs/persistent-tasks.md)
328
+ - [HTTP service and ACP](docs/service.md)
329
+ - [Browser tools](docs/browser.md)
330
+ - [Lifecycle hooks](docs/lifecycle-hooks.md)
331
+ - [Matched agent evaluation](docs/evaluation.md)
332
+ - [Recorded comparison results](docs/evaluation-results.md)
333
+ - [OpenCode v2 comparison and remaining gaps](docs/opencode-v2-comparison.md)
243
334
  - [Development, CI, and releases](docs/development.md)
244
335
  - [Release notes](docs/releases/)
245
336
 
@@ -252,6 +343,10 @@ uv run pytest tests
252
343
  uv build
253
344
  ```
254
345
 
346
+ Regenerate the README screenshots from deterministic sample data with
347
+ `uv run python scripts/capture_readme.py`. This renders the real Textual widgets without making
348
+ provider calls or changing a workspace.
349
+
255
350
  See the [development guide](docs/development.md) for platform checks and the release process.
256
351
 
257
352
  ## License