noah-code 0.8.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 (213) hide show
  1. {noah_code-0.8.0 → noah_code-1.0.0}/PKG-INFO +55 -4
  2. {noah_code-0.8.0 → noah_code-1.0.0}/README.md +53 -3
  3. noah_code-1.0.0/docs/browser.md +43 -0
  4. {noah_code-0.8.0 → noah_code-1.0.0}/docs/configuration.md +67 -6
  5. noah_code-1.0.0/docs/evaluation-results.json +699 -0
  6. noah_code-1.0.0/docs/evaluation-results.md +206 -0
  7. noah_code-1.0.0/docs/evaluation.md +97 -0
  8. noah_code-1.0.0/docs/lifecycle-hooks.md +41 -0
  9. noah_code-1.0.0/docs/opencode-v2-comparison.md +73 -0
  10. noah_code-1.0.0/docs/persistent-tasks.md +60 -0
  11. noah_code-1.0.0/docs/releases/v1.0.0.md +74 -0
  12. {noah_code-0.8.0 → noah_code-1.0.0}/docs/reliability.md +32 -3
  13. noah_code-1.0.0/docs/service.md +128 -0
  14. {noah_code-0.8.0 → noah_code-1.0.0}/pyproject.toml +2 -1
  15. noah_code-1.0.0/scripts/eval_proxy.py +304 -0
  16. noah_code-1.0.0/scripts/evaluate_agents.py +723 -0
  17. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/__init__.py +1 -1
  18. noah_code-1.0.0/src/noah_code/acp.py +493 -0
  19. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/agent.py +157 -41
  20. noah_code-1.0.0/src/noah_code/browser.py +53 -0
  21. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/cli.py +242 -26
  22. noah_code-1.0.0/src/noah_code/codex_account.py +185 -0
  23. noah_code-1.0.0/src/noah_code/codex_client.py +335 -0
  24. noah_code-1.0.0/src/noah_code/codex_rpc.py +304 -0
  25. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/commands.py +3 -0
  26. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/config.py +31 -2
  27. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/credentials.py +17 -0
  28. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/events.py +1 -0
  29. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/hooks.py +64 -4
  30. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/host.py +117 -18
  31. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/llm.py +8 -1
  32. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/llm_replies.py +38 -1
  33. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/macos_sandbox.py +4 -3
  34. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/mcp_setup.py +51 -9
  35. noah_code-1.0.0/src/noah_code/model_streaming.py +275 -0
  36. noah_code-1.0.0/src/noah_code/nooa_compat.py +175 -0
  37. noah_code-1.0.0/src/noah_code/permission_modes.py +38 -0
  38. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/predict.py +6 -0
  39. noah_code-1.0.0/src/noah_code/provider_discovery.py +262 -0
  40. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/providers.py +47 -8
  41. noah_code-1.0.0/src/noah_code/service.py +705 -0
  42. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/steer.py +1 -0
  43. noah_code-1.0.0/src/noah_code/tool_contracts.py +313 -0
  44. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/tools/task_tools.py +313 -40
  45. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/tools/workspace_tools.py +124 -47
  46. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/ui/console.py +23 -0
  47. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/ui/textual.css +38 -0
  48. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/ui/textual_app.py +231 -35
  49. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/verification.py +41 -6
  50. noah_code-1.0.0/tests/evals/fixtures/config-merge/config_merge.py +4 -0
  51. noah_code-1.0.0/tests/evals/fixtures/config-merge/tests/acceptance.py +33 -0
  52. noah_code-1.0.0/tests/evals/fixtures/page-ranges/pages.py +9 -0
  53. noah_code-1.0.0/tests/evals/fixtures/page-ranges/tests/acceptance.py +28 -0
  54. noah_code-1.0.0/tests/evals/tasks.json +43 -0
  55. noah_code-1.0.0/tests/evals/test_evaluate_agents.py +259 -0
  56. noah_code-1.0.0/tests/test_browser.py +223 -0
  57. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_cache_context.py +2 -2
  58. noah_code-1.0.0/tests/test_cell_literal_preservation.py +108 -0
  59. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_cli.py +4 -1
  60. noah_code-1.0.0/tests/test_codex_account.py +253 -0
  61. noah_code-1.0.0/tests/test_codex_client.py +399 -0
  62. noah_code-1.0.0/tests/test_codex_onboarding_cli.py +245 -0
  63. noah_code-1.0.0/tests/test_codex_onboarding_tui.py +198 -0
  64. noah_code-1.0.0/tests/test_completion_verification.py +185 -0
  65. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_console_ui.py +9 -1
  66. noah_code-1.0.0/tests/test_eval_proxy.py +87 -0
  67. noah_code-1.0.0/tests/test_lifecycle_hooks.py +128 -0
  68. noah_code-1.0.0/tests/test_model_streaming.py +518 -0
  69. noah_code-1.0.0/tests/test_permission_modes.py +239 -0
  70. noah_code-1.0.0/tests/test_permission_onboarding_cli.py +178 -0
  71. noah_code-1.0.0/tests/test_permission_onboarding_tui.py +182 -0
  72. noah_code-1.0.0/tests/test_persistent_tasks.py +510 -0
  73. noah_code-1.0.0/tests/test_provider_discovery.py +236 -0
  74. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_providers.py +5 -1
  75. noah_code-1.0.0/tests/test_python_edit_safety.py +243 -0
  76. noah_code-1.0.0/tests/test_service.py +503 -0
  77. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_steer.py +1 -0
  78. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_textual_tui.py +73 -6
  79. noah_code-1.0.0/tests/test_tool_contracts.py +195 -0
  80. noah_code-1.0.0/tests/test_transport_cli.py +261 -0
  81. noah_code-1.0.0/tests/test_truncated_reply_recovery.py +186 -0
  82. noah_code-1.0.0/tests/test_verification_completion.py +188 -0
  83. {noah_code-0.8.0 → noah_code-1.0.0}/uv.lock +3 -1
  84. noah_code-0.8.0/src/noah_code/nooa_compat.py +0 -75
  85. {noah_code-0.8.0 → noah_code-1.0.0}/.github/workflows/ci.yml +0 -0
  86. {noah_code-0.8.0 → noah_code-1.0.0}/.github/workflows/release.yml +0 -0
  87. {noah_code-0.8.0 → noah_code-1.0.0}/.gitignore +0 -0
  88. {noah_code-0.8.0 → noah_code-1.0.0}/.pre-commit-config.yaml +0 -0
  89. {noah_code-0.8.0 → noah_code-1.0.0}/docs/assets/noah-command-menu.svg +0 -0
  90. {noah_code-0.8.0 → noah_code-1.0.0}/docs/assets/noah-in-action.svg +0 -0
  91. {noah_code-0.8.0 → noah_code-1.0.0}/docs/assets/noah-logo.svg +0 -0
  92. {noah_code-0.8.0 → noah_code-1.0.0}/docs/assets/noah-permissions.svg +0 -0
  93. {noah_code-0.8.0 → noah_code-1.0.0}/docs/development.md +0 -0
  94. {noah_code-0.8.0 → noah_code-1.0.0}/docs/extensions.md +0 -0
  95. {noah_code-0.8.0 → noah_code-1.0.0}/docs/interactive-reference.md +0 -0
  96. {noah_code-0.8.0 → noah_code-1.0.0}/docs/releases/v0.1.0.md +0 -0
  97. {noah_code-0.8.0 → noah_code-1.0.0}/docs/releases/v0.1.1.md +0 -0
  98. {noah_code-0.8.0 → noah_code-1.0.0}/docs/releases/v0.2.0.md +0 -0
  99. {noah_code-0.8.0 → noah_code-1.0.0}/docs/releases/v0.2.1.md +0 -0
  100. {noah_code-0.8.0 → noah_code-1.0.0}/docs/releases/v0.2.2.md +0 -0
  101. {noah_code-0.8.0 → noah_code-1.0.0}/docs/releases/v0.2.3.md +0 -0
  102. {noah_code-0.8.0 → noah_code-1.0.0}/docs/releases/v0.2.4.md +0 -0
  103. {noah_code-0.8.0 → noah_code-1.0.0}/docs/releases/v0.3.0.md +0 -0
  104. {noah_code-0.8.0 → noah_code-1.0.0}/docs/releases/v0.4.0.md +0 -0
  105. {noah_code-0.8.0 → noah_code-1.0.0}/docs/releases/v0.4.1.md +0 -0
  106. {noah_code-0.8.0 → noah_code-1.0.0}/docs/releases/v0.5.0.md +0 -0
  107. {noah_code-0.8.0 → noah_code-1.0.0}/docs/releases/v0.5.1.md +0 -0
  108. {noah_code-0.8.0 → noah_code-1.0.0}/docs/releases/v0.6.0.md +0 -0
  109. {noah_code-0.8.0 → noah_code-1.0.0}/docs/releases/v0.7.0.md +0 -0
  110. {noah_code-0.8.0 → noah_code-1.0.0}/docs/releases/v0.8.0.md +0 -0
  111. {noah_code-0.8.0 → noah_code-1.0.0}/docs/security.md +0 -0
  112. {noah_code-0.8.0 → noah_code-1.0.0}/install.sh +0 -0
  113. {noah_code-0.8.0 → noah_code-1.0.0}/scripts/capture_readme.py +0 -0
  114. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/__main__.py +0 -0
  115. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/agents.py +0 -0
  116. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/approvals.py +0 -0
  117. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/budget.py +0 -0
  118. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/checkpoints.py +0 -0
  119. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/composer.py +0 -0
  120. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/custom_commands.py +0 -0
  121. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/event_bridge.py +0 -0
  122. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/github.py +0 -0
  123. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/permissions.py +0 -0
  124. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/project_notes.py +0 -0
  125. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/redaction.py +0 -0
  126. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/runtime_state.py +0 -0
  127. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/secure_files.py +0 -0
  128. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/sessions.py +0 -0
  129. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/skills_setup.py +0 -0
  130. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/snapshots.py +0 -0
  131. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/summarization.py +0 -0
  132. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/teams.py +0 -0
  133. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/telemetry.py +0 -0
  134. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/themes.py +0 -0
  135. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/tool_output.py +0 -0
  136. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/tools/__init__.py +0 -0
  137. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/tools/diff_tools.py +0 -0
  138. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/tools/git_tools.py +0 -0
  139. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/tools/github_tools.py +0 -0
  140. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/tools/lsp_tools.py +0 -0
  141. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/tools/media_tools.py +0 -0
  142. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/tools/memory_tools.py +0 -0
  143. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/tools/plan_tools.py +0 -0
  144. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/tools/process_tools.py +0 -0
  145. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/tools/question_tools.py +0 -0
  146. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/tools/web_tools.py +0 -0
  147. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/ui/__init__.py +0 -0
  148. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/ui/command_menu.py +0 -0
  149. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/ui/protocol.py +0 -0
  150. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/ui/team_screen.py +0 -0
  151. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/updates.py +0 -0
  152. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/usage.py +0 -0
  153. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/workspace.py +0 -0
  154. {noah_code-0.8.0 → noah_code-1.0.0}/src/noah_code/worktree.py +0 -0
  155. {noah_code-0.8.0 → noah_code-1.0.0}/tests/conftest.py +0 -0
  156. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_agent_security.py +0 -0
  157. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_agents.py +0 -0
  158. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_approvals.py +0 -0
  159. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_budget.py +0 -0
  160. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_checkpoints.py +0 -0
  161. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_commands.py +0 -0
  162. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_compaction_eviction.py +0 -0
  163. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_composer.py +0 -0
  164. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_config.py +0 -0
  165. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_credentials.py +0 -0
  166. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_custom_commands.py +0 -0
  167. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_diff_tools.py +0 -0
  168. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_efficiency.py +0 -0
  169. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_event_bridge.py +0 -0
  170. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_event_bridge_and_shell.py +0 -0
  171. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_git_tools.py +0 -0
  172. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_github.py +0 -0
  173. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_hooks.py +0 -0
  174. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_host.py +0 -0
  175. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_installer.py +0 -0
  176. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_lean_reasoning.py +0 -0
  177. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_llm.py +0 -0
  178. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_llm_replies.py +0 -0
  179. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_lsp_tools.py +0 -0
  180. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_mcp_setup.py +0 -0
  181. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_nooa_migration.py +0 -0
  182. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_permissions.py +0 -0
  183. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_plan_memory_tools.py +0 -0
  184. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_process_tools.py +0 -0
  185. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_project_notes.py +0 -0
  186. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_prompt_scorecard.py +0 -0
  187. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_question_tools.py +0 -0
  188. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_redaction.py +0 -0
  189. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_run_exit.py +0 -0
  190. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_runtime_state.py +0 -0
  191. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_sessions.py +0 -0
  192. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_skills_setup.py +0 -0
  193. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_snapshots.py +0 -0
  194. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_summarization.py +0 -0
  195. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_task_tools.py +0 -0
  196. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_teams.py +0 -0
  197. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_telemetry.py +0 -0
  198. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_tool_output.py +0 -0
  199. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_tui_approvals.py +0 -0
  200. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_tui_command_menu.py +0 -0
  201. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_tui_composer_queue.py +0 -0
  202. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_tui_editing.py +0 -0
  203. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_tui_history_dialogs.py +0 -0
  204. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_tui_layout.py +0 -0
  205. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_tui_review_receipt.py +0 -0
  206. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_tui_teams.py +0 -0
  207. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_updates.py +0 -0
  208. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_verification.py +0 -0
  209. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_verification_tools.py +0 -0
  210. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_wave1_e2e.py +0 -0
  211. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_web_tools.py +0 -0
  212. {noah_code-0.8.0 → noah_code-1.0.0}/tests/test_workspace_tools.py +0 -0
  213. {noah_code-0.8.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.8.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
@@ -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
 
@@ -143,6 +145,16 @@ use `F4` to inspect live team progress. In the console, `/team` lists the workfl
143
145
 
144
146
  Useful launch modes:
145
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
+
146
158
  ```bash
147
159
  # Open another workspace
148
160
  noah /path/to/repository
@@ -156,8 +168,11 @@ noah run "Explain how authentication is wired" .
156
168
  # Emit one structured result on stdout (progress goes to stderr)
157
169
  noah run --json "Fix the failing unit test" .
158
170
 
159
- # Allow actions that would normally ask; explicit deny rules still apply
160
- 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 .
161
176
 
162
177
  # Resume previous work
163
178
  noah --continue .
@@ -279,12 +294,23 @@ independent agents need to work concurrently. See
279
294
  [Reliability and long-running sessions](docs/reliability.md) for the recovery model, provider retry
280
295
  controls, quotas, and operational limits.
281
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
+
282
302
  ## Models and providers
283
303
 
284
304
  Noah supports OpenAI, Anthropic, OpenRouter, NVIDIA, and custom OpenAI-compatible providers. It
285
305
  also works with vLLM, LM Studio, Ollama, Azure OpenAI, Bedrock, Gemini, Groq, Mistral, xAI,
286
306
  DeepSeek, Together AI, and Perplexity.
287
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
+
288
314
  The guided `/model` flow is the easiest way to configure a provider. Environment variables and
289
315
  the CLI remain available for scripts and headless environments:
290
316
 
@@ -295,6 +321,12 @@ noah providers add openai --model MODEL_NAME
295
321
  noah .
296
322
  ```
297
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
+
298
330
  `/model MODEL` changes only the current session and remembers that choice when resumed. Use
299
331
  `/model --global MODEL` to set the default for future sessions in every repository.
300
332
 
@@ -309,6 +341,18 @@ See the [provider configuration guide](docs/configuration.md#bring-your-own-api-
309
341
  gateway-specific setup. Provider request deadlines, exponential retry, and ordered fallback models
310
342
  are configured under `[reliability.retries]`.
311
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
+
312
356
  ## Updates
313
357
 
314
358
  Noah checks PyPI for new versions at most once every 24 hours. New TUI sessions show a temporary
@@ -327,6 +371,13 @@ noah update
327
371
  - [Reliability and long-running sessions](docs/reliability.md)
328
372
  - [Generated-code security](docs/security.md)
329
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)
330
381
  - [Development, CI, and releases](docs/development.md)
331
382
  - [Release notes](docs/releases/)
332
383
 
@@ -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
 
@@ -97,6 +98,16 @@ use `F4` to inspect live team progress. In the console, `/team` lists the workfl
97
98
 
98
99
  Useful launch modes:
99
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
+
100
111
  ```bash
101
112
  # Open another workspace
102
113
  noah /path/to/repository
@@ -110,8 +121,11 @@ noah run "Explain how authentication is wired" .
110
121
  # Emit one structured result on stdout (progress goes to stderr)
111
122
  noah run --json "Fix the failing unit test" .
112
123
 
113
- # Allow actions that would normally ask; explicit deny rules still apply
114
- 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 .
115
129
 
116
130
  # Resume previous work
117
131
  noah --continue .
@@ -233,12 +247,23 @@ independent agents need to work concurrently. See
233
247
  [Reliability and long-running sessions](docs/reliability.md) for the recovery model, provider retry
234
248
  controls, quotas, and operational limits.
235
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
+
236
255
  ## Models and providers
237
256
 
238
257
  Noah supports OpenAI, Anthropic, OpenRouter, NVIDIA, and custom OpenAI-compatible providers. It
239
258
  also works with vLLM, LM Studio, Ollama, Azure OpenAI, Bedrock, Gemini, Groq, Mistral, xAI,
240
259
  DeepSeek, Together AI, and Perplexity.
241
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
+
242
267
  The guided `/model` flow is the easiest way to configure a provider. Environment variables and
243
268
  the CLI remain available for scripts and headless environments:
244
269
 
@@ -249,6 +274,12 @@ noah providers add openai --model MODEL_NAME
249
274
  noah .
250
275
  ```
251
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
+
252
283
  `/model MODEL` changes only the current session and remembers that choice when resumed. Use
253
284
  `/model --global MODEL` to set the default for future sessions in every repository.
254
285
 
@@ -263,6 +294,18 @@ See the [provider configuration guide](docs/configuration.md#bring-your-own-api-
263
294
  gateway-specific setup. Provider request deadlines, exponential retry, and ordered fallback models
264
295
  are configured under `[reliability.retries]`.
265
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
+
266
309
  ## Updates
267
310
 
268
311
  Noah checks PyPI for new versions at most once every 24 hours. New TUI sessions show a temporary
@@ -281,6 +324,13 @@ noah update
281
324
  - [Reliability and long-running sessions](docs/reliability.md)
282
325
  - [Generated-code security](docs/security.md)
283
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)
284
334
  - [Development, CI, and releases](docs/development.md)
285
335
  - [Release notes](docs/releases/)
286
336
 
@@ -0,0 +1,43 @@
1
+ # Browser tools
2
+
3
+ Enable browser interaction explicitly:
4
+
5
+ ```bash
6
+ noah browser setup
7
+ ```
8
+
9
+ This saves a Playwright MCP entry in `~/.config/noah-code/mcp.json`. It does not
10
+ launch a browser or install software during setup. Restart Noah to attach the
11
+ configured server through normal MCP startup. Setup preserves other servers and
12
+ refuses to replace an existing entry named `browser`.
13
+
14
+ Install Noah's MCP extra and have Node.js 18 or newer with `npx` available. From
15
+ a source checkout, install the extra with `uv sync --extra mcp`. On first
16
+ connection, `npx` may download the pinned `@playwright/mcp@0.0.82` package.
17
+
18
+ The preset uses an isolated in-memory profile and runs headlessly. It does not
19
+ connect to existing browser tabs or reuse your regular login profile. Browser
20
+ storage disappears when its session closes. Choose a visible window with
21
+ `noah browser setup --headed`; select a browser with `--browser firefox`,
22
+ `--browser webkit`, or `--browser msedge` (default: `chrome`). The selected browser
23
+ must be installed; Playwright MCP exposes `browser_install` when installation
24
+ is needed.
25
+
26
+ Ask Noah to open your local application, inspect its page snapshot, exercise a
27
+ form, inspect console/network output, or capture a screenshot. The tools appear
28
+ under `self.browser` after attachment. Browser mutations, including navigation
29
+ and script evaluation, use MCP permission checks and are denied in plan mode.
30
+ Unknown browser actions are treated as mutations. Snapshot, console, and network
31
+ inspection are read-only unless an output filename is supplied. Interrupted
32
+ browser actions are not automatically replayed; this is not transactional
33
+ rollback of changes made in the browser or on a website.
34
+
35
+ To disable the server, add `"disabled": true` to its entry in `mcp.json` and
36
+ restart Noah. Existing configuration and permission precedence still apply.
37
+
38
+ The preset follows Microsoft's [Playwright MCP configuration](https://github.com/microsoft/playwright-mcp#configuration)
39
+ and [isolated-profile behavior](https://github.com/microsoft/playwright-mcp#user-profile).
40
+ Package version and Node requirement were checked against the
41
+ [official npm package metadata](https://registry.npmjs.org/@playwright/mcp/0.0.82)
42
+ on September 26, 2026. MCP connection tests use a local fake server; browser
43
+ launch and npm installation require a configured local environment.
@@ -10,10 +10,34 @@ Configuration is merged in this order, with later layers taking precedence:
10
10
  4. `NOAH_CODE_*` environment variables.
11
11
  5. CLI flags.
12
12
 
13
- ### First-run model setup
14
-
15
- The first TUI launch opens one guided provider → API key → model → reasoning flow before starting
16
- the agent. Noah Code saves the selected model as the top-level `model` in
13
+ ### First-run permissions and model setup
14
+
15
+ The first interactive launch asks for a permission mode before starting the agent. Each choice
16
+ has a one-line explanation, and **Normal** is initially selected:
17
+
18
+ | Choice | Behavior |
19
+ | --- | --- |
20
+ | Normal (recommended) | Ask before commands that need approval; keep protective blocks enabled. |
21
+ | Auto | Approve routine actions automatically; block interpreters and keep risky-action approvals. |
22
+ | YOLO | Skip permission checks and approval prompts; use only in isolated, trusted workspaces. |
23
+
24
+ The choice atomically saves both `auto_approve` and `yolo` in the trusted user config. Existing
25
+ explicit settings are respected. Users without a saved permission preference are asked once,
26
+ even if their model is already configured. Cancelling leaves setup pending; it does not select
27
+ YOLO or start the agent. The console offers the same choices with Normal as its default.
28
+
29
+ Override the saved preference for one launch with `--permissions normal|auto|yolo`. Existing
30
+ `--auto` and `--yolo` flags select those modes and clear the other flag for that launch; conflicting
31
+ choices are rejected. Explicit CLI choices, `NOAH_CODE_AUTO`, resumed sessions, and noninteractive
32
+ `run`/`serve`/`acp` launches do not trigger the new setup question. Model configuration and build/plan
33
+ mode remain separate, and the execution sandbox is unchanged. `NOAH_CODE_AUTO=true` selects Auto,
34
+ and `NOAH_CODE_AUTO=false` selects Normal; both clear a saved YOLO setting for that launch. Explicit
35
+ CLI choices take precedence over the environment. To change the saved preference,
36
+ set both top-level booleans in your user config (`false`/`false` for Normal, `true`/`false` for Auto,
37
+ `false`/`true` for YOLO).
38
+
39
+ The TUI then opens the guided provider → account sign-in or API key → model → reasoning flow when model setup is
40
+ needed. Noah Code saves the selected model as the top-level `model` in
17
41
  `~/.config/noah-code/config.toml`, making it the default for every repository, and stores provider
18
42
  credentials separately in its private auth file. The classic `--console` frontend retains a
19
43
  line-oriented model prompt for environments that cannot open the TUI.
@@ -31,8 +55,8 @@ Inside an interactive session, switch only the current session or replace the gl
31
55
  /model --global anthropic/MODEL_NAME
32
56
  ```
33
57
 
34
- Bare `/model` opens a guided TUI flow: search for a provider, enter its API key in a masked
35
- field, enter the model ID, and select reasoning effort. Noah saves the credential in
58
+ Bare `/model` opens a guided TUI flow: search for a provider, connect your Codex account or enter
59
+ an API key in a masked field, choose a model, and select reasoning effort. Noah saves API keys in
36
60
  `~/.local/share/noah-code/auth.json`, using the same provider-keyed record shape as OpenCode.
37
61
  The containing directory uses mode `0700` and the file uses mode `0600`. If the file cannot be
38
62
  written, the key remains active only in the current Noah process and the TUI says so. Keys are
@@ -42,6 +66,43 @@ Model switches take effect between turns and are stored in the current session m
42
66
  resumed session continues with its most recently selected model. A session-only `/model MODEL`
43
67
  does not change the user configuration or affect new sessions.
44
68
 
69
+ ### Codex / ChatGPT account
70
+
71
+ Choose **Codex / ChatGPT account** in the first-run provider picker or `/model`.
72
+ Install the [official Codex CLI](https://learn.chatgpt.com/docs/cli), version 0.153.4 or newer,
73
+ and complete the browser sign-in shown by Noah. Then choose a model from Codex's model list
74
+ and select reasoning effort. In the console's first-run model prompt, enter `codex`.
75
+
76
+ ```bash
77
+ noah providers login codex
78
+ # For SSH or a machine without a browser:
79
+ noah providers login codex --device-code
80
+ # Select a known Codex model explicitly:
81
+ noah providers login codex --model MODEL_NAME
82
+ ```
83
+
84
+ The saved route is `codex/MODEL_NAME`. This uses your ChatGPT account's Codex access and usage
85
+ limits; it does not require `OPENAI_API_KEY`. Available models and reasoning levels depend on
86
+ your account and Codex version. Codex account usage is not metered as API-dollar spend by Noah.
87
+ Token usage is recorded when Codex reports it; calls handed back to Noah for tool execution may
88
+ end before usage arrives. Use a time budget for a local cap, and check Codex for account limits.
89
+
90
+ Sign-in uses the [official app-server account flow](https://learn.chatgpt.com/docs/app-server#auth-endpoints)
91
+ over a local stdio process. Codex stores and refreshes credentials in
92
+ `~/.local/share/noah-code/codex` (`$XDG_DATA_HOME/noah-code/codex` when set), with owner-only
93
+ access. Noah does not copy credentials from the desktop app or the regular Codex CLI login.
94
+ The first connection requires sign-in; subsequent connections reuse Noah's Codex login.
95
+ OAuth tokens never enter Noah config, its API-key store, or session history. Cancel the
96
+ sign-in dialog to stop a pending login without changing the selected model.
97
+
98
+ Noah continues running its own tools and enforcing your chosen Normal, Auto, or YOLO mode.
99
+ The adapter uses ephemeral Codex threads with environment access disabled; Codex does not
100
+ run commands or edit the workspace itself. This integration uses experimental app-server
101
+ fields and requires the version check above. Unsupported protocol behavior fails with an
102
+ error instead of falling back to a different provider or bypassing Noah permissions.
103
+ Sampling overrides (`temperature`, `top_p`, `seed`) and per-call `max_tokens` are not supported
104
+ by this transport; remove them from Noah settings when selecting an account model.
105
+
45
106
  ### Bring your own API provider
46
107
 
47
108
  Enter `/model` for the common provider → API key → model flow. Run `noah providers list` or open