noah-code 0.8.0__tar.gz → 2.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 (217) hide show
  1. {noah_code-0.8.0 → noah_code-2.0.0}/PKG-INFO +61 -11
  2. {noah_code-0.8.0 → noah_code-2.0.0}/README.md +54 -5
  3. noah_code-2.0.0/docs/browser.md +43 -0
  4. {noah_code-0.8.0 → noah_code-2.0.0}/docs/configuration.md +67 -6
  5. noah_code-2.0.0/docs/evaluation-results.json +699 -0
  6. noah_code-2.0.0/docs/evaluation-results.md +206 -0
  7. noah_code-2.0.0/docs/evaluation.md +97 -0
  8. noah_code-2.0.0/docs/lifecycle-hooks.md +41 -0
  9. noah_code-2.0.0/docs/opencode-v2-comparison.md +73 -0
  10. noah_code-2.0.0/docs/persistent-tasks.md +60 -0
  11. noah_code-2.0.0/docs/releases/v1.0.0.md +74 -0
  12. noah_code-2.0.0/docs/releases/v2.0.0.md +40 -0
  13. {noah_code-0.8.0 → noah_code-2.0.0}/docs/reliability.md +32 -3
  14. noah_code-2.0.0/docs/service.md +128 -0
  15. {noah_code-0.8.0 → noah_code-2.0.0}/install.sh +12 -6
  16. {noah_code-0.8.0 → noah_code-2.0.0}/pyproject.toml +7 -7
  17. noah_code-2.0.0/scripts/eval_proxy.py +322 -0
  18. noah_code-2.0.0/scripts/evaluate_agents.py +775 -0
  19. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/__init__.py +1 -1
  20. noah_code-2.0.0/src/noah_code/acp.py +505 -0
  21. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/agent.py +200 -85
  22. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/agents.py +4 -2
  23. noah_code-2.0.0/src/noah_code/browser.py +53 -0
  24. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/budget.py +75 -26
  25. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/checkpoints.py +30 -10
  26. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/cli.py +418 -115
  27. noah_code-2.0.0/src/noah_code/codex_account.py +185 -0
  28. noah_code-2.0.0/src/noah_code/codex_client.py +324 -0
  29. noah_code-2.0.0/src/noah_code/codex_rpc.py +305 -0
  30. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/commands.py +21 -1
  31. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/composer.py +65 -9
  32. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/config.py +55 -2
  33. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/credentials.py +24 -3
  34. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/custom_commands.py +39 -19
  35. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/event_bridge.py +41 -8
  36. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/events.py +1 -0
  37. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/github.py +119 -18
  38. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/hooks.py +64 -4
  39. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/host.py +323 -62
  40. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/llm.py +36 -3
  41. noah_code-2.0.0/src/noah_code/llm_replies.py +164 -0
  42. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/macos_sandbox.py +20 -9
  43. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/mcp_setup.py +143 -15
  44. noah_code-2.0.0/src/noah_code/model_streaming.py +299 -0
  45. noah_code-2.0.0/src/noah_code/nooa_compat.py +197 -0
  46. noah_code-2.0.0/src/noah_code/permission_modes.py +38 -0
  47. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/permissions.py +194 -73
  48. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/predict.py +8 -0
  49. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/project_notes.py +18 -6
  50. noah_code-2.0.0/src/noah_code/provider_discovery.py +262 -0
  51. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/providers.py +47 -8
  52. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/redaction.py +22 -13
  53. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/runtime_state.py +54 -24
  54. noah_code-2.0.0/src/noah_code/service.py +796 -0
  55. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/skills_setup.py +95 -15
  56. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/snapshots.py +132 -30
  57. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/steer.py +14 -2
  58. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/telemetry.py +156 -22
  59. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/themes.py +16 -0
  60. noah_code-2.0.0/src/noah_code/tool_contracts.py +313 -0
  61. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/tool_output.py +23 -3
  62. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/tools/diff_tools.py +98 -33
  63. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/tools/git_tools.py +138 -42
  64. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/tools/github_tools.py +75 -16
  65. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/tools/lsp_tools.py +188 -34
  66. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/tools/memory_tools.py +10 -1
  67. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/tools/plan_tools.py +13 -4
  68. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/tools/process_tools.py +93 -40
  69. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/tools/question_tools.py +3 -1
  70. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/tools/task_tools.py +392 -54
  71. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/tools/web_tools.py +73 -17
  72. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/tools/workspace_tools.py +249 -103
  73. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/ui/console.py +50 -4
  74. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/ui/textual.css +55 -4
  75. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/ui/textual_app.py +616 -156
  76. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/updates.py +20 -4
  77. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/usage.py +17 -5
  78. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/verification.py +72 -19
  79. noah_code-2.0.0/src/noah_code/workspace.py +124 -0
  80. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/worktree.py +42 -9
  81. {noah_code-0.8.0 → noah_code-2.0.0}/tests/conftest.py +16 -0
  82. noah_code-2.0.0/tests/evals/fixtures/config-merge/config_merge.py +4 -0
  83. noah_code-2.0.0/tests/evals/fixtures/config-merge/tests/acceptance.py +33 -0
  84. noah_code-2.0.0/tests/evals/fixtures/page-ranges/pages.py +9 -0
  85. noah_code-2.0.0/tests/evals/fixtures/page-ranges/tests/acceptance.py +28 -0
  86. noah_code-2.0.0/tests/evals/tasks.json +43 -0
  87. noah_code-2.0.0/tests/evals/test_evaluate_agents.py +259 -0
  88. noah_code-2.0.0/tests/test_browser.py +223 -0
  89. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_budget.py +1 -1
  90. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_cache_context.py +6 -4
  91. noah_code-2.0.0/tests/test_cell_literal_preservation.py +108 -0
  92. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_cli.py +88 -3
  93. noah_code-2.0.0/tests/test_codex_account.py +253 -0
  94. noah_code-2.0.0/tests/test_codex_client.py +405 -0
  95. noah_code-2.0.0/tests/test_codex_onboarding_cli.py +245 -0
  96. noah_code-2.0.0/tests/test_codex_onboarding_tui.py +198 -0
  97. noah_code-2.0.0/tests/test_completion_verification.py +188 -0
  98. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_console_ui.py +9 -1
  99. noah_code-2.0.0/tests/test_eval_proxy.py +112 -0
  100. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_event_bridge.py +1 -1
  101. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_host.py +16 -28
  102. noah_code-2.0.0/tests/test_lean_reasoning.py +190 -0
  103. noah_code-2.0.0/tests/test_lifecycle_hooks.py +128 -0
  104. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_llm_replies.py +35 -7
  105. noah_code-2.0.0/tests/test_model_streaming.py +524 -0
  106. noah_code-2.0.0/tests/test_permission_modes.py +239 -0
  107. noah_code-2.0.0/tests/test_permission_onboarding_cli.py +178 -0
  108. noah_code-2.0.0/tests/test_permission_onboarding_tui.py +182 -0
  109. noah_code-2.0.0/tests/test_persistent_tasks.py +509 -0
  110. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_plan_memory_tools.py +16 -3
  111. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_prompt_scorecard.py +14 -10
  112. noah_code-2.0.0/tests/test_provider_discovery.py +236 -0
  113. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_providers.py +5 -1
  114. noah_code-2.0.0/tests/test_python_edit_safety.py +243 -0
  115. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_redaction.py +10 -1
  116. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_run_exit.py +9 -6
  117. noah_code-2.0.0/tests/test_service.py +503 -0
  118. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_steer.py +1 -0
  119. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_task_tools.py +3 -4
  120. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_telemetry.py +33 -0
  121. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_textual_tui.py +231 -6
  122. noah_code-2.0.0/tests/test_tool_contracts.py +195 -0
  123. noah_code-2.0.0/tests/test_transport_cli.py +261 -0
  124. noah_code-2.0.0/tests/test_truncated_reply_recovery.py +209 -0
  125. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_updates.py +31 -0
  126. noah_code-2.0.0/tests/test_verification_completion.py +188 -0
  127. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_wave1_e2e.py +2 -4
  128. {noah_code-0.8.0 → noah_code-2.0.0}/uv.lock +192 -156
  129. noah_code-0.8.0/src/noah_code/llm_replies.py +0 -98
  130. noah_code-0.8.0/src/noah_code/nooa_compat.py +0 -75
  131. noah_code-0.8.0/src/noah_code/workspace.py +0 -52
  132. noah_code-0.8.0/tests/test_lean_reasoning.py +0 -201
  133. {noah_code-0.8.0 → noah_code-2.0.0}/.github/workflows/ci.yml +0 -0
  134. {noah_code-0.8.0 → noah_code-2.0.0}/.github/workflows/release.yml +0 -0
  135. {noah_code-0.8.0 → noah_code-2.0.0}/.gitignore +0 -0
  136. {noah_code-0.8.0 → noah_code-2.0.0}/.pre-commit-config.yaml +0 -0
  137. {noah_code-0.8.0 → noah_code-2.0.0}/docs/assets/noah-command-menu.svg +0 -0
  138. {noah_code-0.8.0 → noah_code-2.0.0}/docs/assets/noah-in-action.svg +0 -0
  139. {noah_code-0.8.0 → noah_code-2.0.0}/docs/assets/noah-logo.svg +0 -0
  140. {noah_code-0.8.0 → noah_code-2.0.0}/docs/assets/noah-permissions.svg +0 -0
  141. {noah_code-0.8.0 → noah_code-2.0.0}/docs/development.md +0 -0
  142. {noah_code-0.8.0 → noah_code-2.0.0}/docs/extensions.md +0 -0
  143. {noah_code-0.8.0 → noah_code-2.0.0}/docs/interactive-reference.md +0 -0
  144. {noah_code-0.8.0 → noah_code-2.0.0}/docs/releases/v0.1.0.md +0 -0
  145. {noah_code-0.8.0 → noah_code-2.0.0}/docs/releases/v0.1.1.md +0 -0
  146. {noah_code-0.8.0 → noah_code-2.0.0}/docs/releases/v0.2.0.md +0 -0
  147. {noah_code-0.8.0 → noah_code-2.0.0}/docs/releases/v0.2.1.md +0 -0
  148. {noah_code-0.8.0 → noah_code-2.0.0}/docs/releases/v0.2.2.md +0 -0
  149. {noah_code-0.8.0 → noah_code-2.0.0}/docs/releases/v0.2.3.md +0 -0
  150. {noah_code-0.8.0 → noah_code-2.0.0}/docs/releases/v0.2.4.md +0 -0
  151. {noah_code-0.8.0 → noah_code-2.0.0}/docs/releases/v0.3.0.md +0 -0
  152. {noah_code-0.8.0 → noah_code-2.0.0}/docs/releases/v0.4.0.md +0 -0
  153. {noah_code-0.8.0 → noah_code-2.0.0}/docs/releases/v0.4.1.md +0 -0
  154. {noah_code-0.8.0 → noah_code-2.0.0}/docs/releases/v0.5.0.md +0 -0
  155. {noah_code-0.8.0 → noah_code-2.0.0}/docs/releases/v0.5.1.md +0 -0
  156. {noah_code-0.8.0 → noah_code-2.0.0}/docs/releases/v0.6.0.md +0 -0
  157. {noah_code-0.8.0 → noah_code-2.0.0}/docs/releases/v0.7.0.md +0 -0
  158. {noah_code-0.8.0 → noah_code-2.0.0}/docs/releases/v0.8.0.md +0 -0
  159. {noah_code-0.8.0 → noah_code-2.0.0}/docs/security.md +0 -0
  160. {noah_code-0.8.0 → noah_code-2.0.0}/scripts/capture_readme.py +0 -0
  161. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/__main__.py +0 -0
  162. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/approvals.py +0 -0
  163. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/secure_files.py +0 -0
  164. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/sessions.py +0 -0
  165. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/summarization.py +0 -0
  166. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/teams.py +0 -0
  167. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/tools/__init__.py +0 -0
  168. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/tools/media_tools.py +0 -0
  169. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/ui/__init__.py +0 -0
  170. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/ui/command_menu.py +0 -0
  171. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/ui/protocol.py +0 -0
  172. {noah_code-0.8.0 → noah_code-2.0.0}/src/noah_code/ui/team_screen.py +0 -0
  173. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_agent_security.py +0 -0
  174. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_agents.py +0 -0
  175. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_approvals.py +0 -0
  176. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_checkpoints.py +0 -0
  177. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_commands.py +0 -0
  178. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_compaction_eviction.py +0 -0
  179. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_composer.py +0 -0
  180. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_config.py +0 -0
  181. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_credentials.py +0 -0
  182. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_custom_commands.py +0 -0
  183. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_diff_tools.py +0 -0
  184. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_efficiency.py +0 -0
  185. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_event_bridge_and_shell.py +0 -0
  186. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_git_tools.py +0 -0
  187. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_github.py +0 -0
  188. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_hooks.py +0 -0
  189. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_installer.py +0 -0
  190. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_llm.py +0 -0
  191. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_lsp_tools.py +0 -0
  192. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_mcp_setup.py +0 -0
  193. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_nooa_migration.py +0 -0
  194. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_permissions.py +0 -0
  195. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_process_tools.py +0 -0
  196. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_project_notes.py +0 -0
  197. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_question_tools.py +0 -0
  198. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_runtime_state.py +0 -0
  199. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_sessions.py +0 -0
  200. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_skills_setup.py +0 -0
  201. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_snapshots.py +0 -0
  202. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_summarization.py +0 -0
  203. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_teams.py +0 -0
  204. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_tool_output.py +0 -0
  205. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_tui_approvals.py +0 -0
  206. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_tui_command_menu.py +0 -0
  207. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_tui_composer_queue.py +0 -0
  208. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_tui_editing.py +0 -0
  209. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_tui_history_dialogs.py +0 -0
  210. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_tui_layout.py +0 -0
  211. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_tui_review_receipt.py +0 -0
  212. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_tui_teams.py +0 -0
  213. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_verification.py +0 -0
  214. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_verification_tools.py +0 -0
  215. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_web_tools.py +0 -0
  216. {noah_code-0.8.0 → noah_code-2.0.0}/tests/test_workspace_tools.py +0 -0
  217. {noah_code-0.8.0 → noah_code-2.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: 2.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,9 +20,10 @@ 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: litellm<1.99.0,>=1.96.0
24
- Requires-Dist: nooa-cli==0.0.10
25
- Requires-Dist: nooa==0.0.10
23
+ Requires-Dist: httpx<1.0.0,>=0.28.1
24
+ Requires-Dist: litellm<1.106.0,>=1.97.0
25
+ Requires-Dist: nooa-cli==0.0.12
26
+ Requires-Dist: nooa==0.0.12
26
27
  Requires-Dist: packaging<27.0,>=24.0
27
28
  Requires-Dist: pydantic<3.0.0,>=2.5.0
28
29
  Requires-Dist: pyyaml<7.0.0,>=6.0.0
@@ -38,9 +39,9 @@ Requires-Dist: pytest>=8.0.0; extra == 'dev'
38
39
  Requires-Dist: ruff>=0.8.0; extra == 'dev'
39
40
  Requires-Dist: types-pyyaml>=6.0.12.20260815; extra == 'dev'
40
41
  Provides-Extra: mcp
41
- Requires-Dist: nooa[mcp]==0.0.10; extra == 'mcp'
42
+ Requires-Dist: nooa[mcp]==0.0.12; extra == 'mcp'
42
43
  Provides-Extra: tracing
43
- Requires-Dist: nooa[tracing]==0.0.10; extra == 'tracing'
44
+ Requires-Dist: nooa[tracing]==0.0.12; extra == 'tracing'
44
45
  Requires-Dist: opentelemetry-exporter-otlp-proto-http<2.0.0,>=1.44.0; extra == 'tracing'
45
46
  Description-Content-Type: text/markdown
46
47
 
@@ -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 .
@@ -183,8 +198,7 @@ noah config show .
183
198
  noah update --check
184
199
  ```
185
200
 
186
- The package also installs `noah-code` and `nc` as equivalent entry points. Because `nc` commonly
187
- means netcat, `noah` or `noah-code` is recommended.
201
+ The package also installs `noah-code` alongside `noah` as an equivalent entry point.
188
202
 
189
203
  ## Inside the TUI
190
204
 
@@ -279,12 +293,23 @@ independent agents need to work concurrently. See
279
293
  [Reliability and long-running sessions](docs/reliability.md) for the recovery model, provider retry
280
294
  controls, quotas, and operational limits.
281
295
 
296
+ Child agents also retain their own conversation snapshots and task IDs. Noah can start,
297
+ inspect, cancel, wait for, and follow up with a child independently. Background writers use
298
+ an optional Git worktree created from committed `HEAD`; local uncommitted changes stay in
299
+ the parent checkout. See [persistent child tasks](docs/persistent-tasks.md).
300
+
282
301
  ## Models and providers
283
302
 
284
303
  Noah supports OpenAI, Anthropic, OpenRouter, NVIDIA, and custom OpenAI-compatible providers. It
285
304
  also works with vLLM, LM Studio, Ollama, Azure OpenAI, Bedrock, Gemini, Groq, Mistral, xAI,
286
305
  DeepSeek, Together AI, and Perplexity.
287
306
 
307
+ You can also connect your **Codex / ChatGPT account** directly in `/model`, without an API key.
308
+ Install the [Codex CLI](https://learn.chatgpt.com/docs/cli) (0.153.4 or newer), then select that
309
+ option or run `noah providers login codex`. On a headless machine, add `--device-code`.
310
+ Noah uses the official Codex app server and a separate Codex-managed login store; account usage
311
+ counts toward your Codex limits. See [account setup](docs/configuration.md#codex--chatgpt-account).
312
+
288
313
  The guided `/model` flow is the easiest way to configure a provider. Environment variables and
289
314
  the CLI remain available for scripts and headless environments:
290
315
 
@@ -295,6 +320,12 @@ noah providers add openai --model MODEL_NAME
295
320
  noah .
296
321
  ```
297
322
 
323
+ Setup offers a searchable model picker, live model discovery for compatible endpoints, and
324
+ manual model entry. Catalog entries whose account access has not been checked are labeled.
325
+ Supported completion clients show incremental generation in a temporary terminal preview;
326
+ the parsed answer is saved when generation completes. Responses clients retain their existing
327
+ completed-response behavior.
328
+
298
329
  `/model MODEL` changes only the current session and remembers that choice when resumed. Use
299
330
  `/model --global MODEL` to set the default for future sessions in every repository.
300
331
 
@@ -309,6 +340,18 @@ See the [provider configuration guide](docs/configuration.md#bring-your-own-api-
309
340
  gateway-specific setup. Provider request deadlines, exponential retry, and ordered fallback models
310
341
  are configured under `[reliability.retries]`.
311
342
 
343
+ ## Integrations
344
+
345
+ `noah serve` exposes authenticated loopback HTTP and resumable event streams; set
346
+ `NOAH_CODE_SERVER_TOKEN` to a random token of at least 32 characters before starting it.
347
+ `noah acp` exposes the same agent host through ACP v1 for compatible editors. See
348
+ [service and ACP](docs/service.md) for endpoints and supported capabilities.
349
+
350
+ `noah browser setup` configures the pinned Playwright MCP browser preset. It uses an isolated
351
+ browser profile and Noah's tool permissions; Node.js and a supported browser are required.
352
+ See [browser tools](docs/browser.md). Trusted user configuration can also run
353
+ [lifecycle hooks](docs/lifecycle-hooks.md) for session, turn, and worktree events.
354
+
312
355
  ## Updates
313
356
 
314
357
  Noah checks PyPI for new versions at most once every 24 hours. New TUI sessions show a temporary
@@ -327,6 +370,13 @@ noah update
327
370
  - [Reliability and long-running sessions](docs/reliability.md)
328
371
  - [Generated-code security](docs/security.md)
329
372
  - [Custom commands, skills, MCP, and tracing](docs/extensions.md)
373
+ - [Persistent child tasks](docs/persistent-tasks.md)
374
+ - [HTTP service and ACP](docs/service.md)
375
+ - [Browser tools](docs/browser.md)
376
+ - [Lifecycle hooks](docs/lifecycle-hooks.md)
377
+ - [Matched agent evaluation](docs/evaluation.md)
378
+ - [Recorded comparison results](docs/evaluation-results.md)
379
+ - [OpenCode v2 comparison and remaining gaps](docs/opencode-v2-comparison.md)
330
380
  - [Development, CI, and releases](docs/development.md)
331
381
  - [Release notes](docs/releases/)
332
382
 
@@ -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 .
@@ -137,8 +151,7 @@ noah config show .
137
151
  noah update --check
138
152
  ```
139
153
 
140
- The package also installs `noah-code` and `nc` as equivalent entry points. Because `nc` commonly
141
- means netcat, `noah` or `noah-code` is recommended.
154
+ The package also installs `noah-code` alongside `noah` as an equivalent entry point.
142
155
 
143
156
  ## Inside the TUI
144
157
 
@@ -233,12 +246,23 @@ independent agents need to work concurrently. See
233
246
  [Reliability and long-running sessions](docs/reliability.md) for the recovery model, provider retry
234
247
  controls, quotas, and operational limits.
235
248
 
249
+ Child agents also retain their own conversation snapshots and task IDs. Noah can start,
250
+ inspect, cancel, wait for, and follow up with a child independently. Background writers use
251
+ an optional Git worktree created from committed `HEAD`; local uncommitted changes stay in
252
+ the parent checkout. See [persistent child tasks](docs/persistent-tasks.md).
253
+
236
254
  ## Models and providers
237
255
 
238
256
  Noah supports OpenAI, Anthropic, OpenRouter, NVIDIA, and custom OpenAI-compatible providers. It
239
257
  also works with vLLM, LM Studio, Ollama, Azure OpenAI, Bedrock, Gemini, Groq, Mistral, xAI,
240
258
  DeepSeek, Together AI, and Perplexity.
241
259
 
260
+ You can also connect your **Codex / ChatGPT account** directly in `/model`, without an API key.
261
+ Install the [Codex CLI](https://learn.chatgpt.com/docs/cli) (0.153.4 or newer), then select that
262
+ option or run `noah providers login codex`. On a headless machine, add `--device-code`.
263
+ Noah uses the official Codex app server and a separate Codex-managed login store; account usage
264
+ counts toward your Codex limits. See [account setup](docs/configuration.md#codex--chatgpt-account).
265
+
242
266
  The guided `/model` flow is the easiest way to configure a provider. Environment variables and
243
267
  the CLI remain available for scripts and headless environments:
244
268
 
@@ -249,6 +273,12 @@ noah providers add openai --model MODEL_NAME
249
273
  noah .
250
274
  ```
251
275
 
276
+ Setup offers a searchable model picker, live model discovery for compatible endpoints, and
277
+ manual model entry. Catalog entries whose account access has not been checked are labeled.
278
+ Supported completion clients show incremental generation in a temporary terminal preview;
279
+ the parsed answer is saved when generation completes. Responses clients retain their existing
280
+ completed-response behavior.
281
+
252
282
  `/model MODEL` changes only the current session and remembers that choice when resumed. Use
253
283
  `/model --global MODEL` to set the default for future sessions in every repository.
254
284
 
@@ -263,6 +293,18 @@ See the [provider configuration guide](docs/configuration.md#bring-your-own-api-
263
293
  gateway-specific setup. Provider request deadlines, exponential retry, and ordered fallback models
264
294
  are configured under `[reliability.retries]`.
265
295
 
296
+ ## Integrations
297
+
298
+ `noah serve` exposes authenticated loopback HTTP and resumable event streams; set
299
+ `NOAH_CODE_SERVER_TOKEN` to a random token of at least 32 characters before starting it.
300
+ `noah acp` exposes the same agent host through ACP v1 for compatible editors. See
301
+ [service and ACP](docs/service.md) for endpoints and supported capabilities.
302
+
303
+ `noah browser setup` configures the pinned Playwright MCP browser preset. It uses an isolated
304
+ browser profile and Noah's tool permissions; Node.js and a supported browser are required.
305
+ See [browser tools](docs/browser.md). Trusted user configuration can also run
306
+ [lifecycle hooks](docs/lifecycle-hooks.md) for session, turn, and worktree events.
307
+
266
308
  ## Updates
267
309
 
268
310
  Noah checks PyPI for new versions at most once every 24 hours. New TUI sessions show a temporary
@@ -281,6 +323,13 @@ noah update
281
323
  - [Reliability and long-running sessions](docs/reliability.md)
282
324
  - [Generated-code security](docs/security.md)
283
325
  - [Custom commands, skills, MCP, and tracing](docs/extensions.md)
326
+ - [Persistent child tasks](docs/persistent-tasks.md)
327
+ - [HTTP service and ACP](docs/service.md)
328
+ - [Browser tools](docs/browser.md)
329
+ - [Lifecycle hooks](docs/lifecycle-hooks.md)
330
+ - [Matched agent evaluation](docs/evaluation.md)
331
+ - [Recorded comparison results](docs/evaluation-results.md)
332
+ - [OpenCode v2 comparison and remaining gaps](docs/opencode-v2-comparison.md)
284
333
  - [Development, CI, and releases](docs/development.md)
285
334
  - [Release notes](docs/releases/)
286
335
 
@@ -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