dostuff 0.2.15__tar.gz → 0.2.16__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 (204) hide show
  1. {dostuff-0.2.15 → dostuff-0.2.16}/PKG-INFO +38 -13
  2. {dostuff-0.2.15 → dostuff-0.2.16}/README.md +37 -12
  3. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/agent/call_agent.py +35 -8
  4. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/agent/loop.py +60 -12
  5. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/agent/subagents/definitions.py +75 -7
  6. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/agent/subagents/fork.py +12 -4
  7. dostuff-0.2.16/dostuff/agent/subagents/prompt.py +129 -0
  8. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/agent/subagents/registry.py +12 -4
  9. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/agent/subagents/run.py +7 -2
  10. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/cli_tui.py +726 -79
  11. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/config.py +30 -0
  12. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/constants.py +5 -0
  13. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/tool_output.py +29 -0
  14. dostuff-0.2.16/dostuff/helpers/extras.py +40 -0
  15. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/skills/skill_command.py +12 -2
  16. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/ui/doctor.py +10 -0
  17. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/ui/tools_listing.py +13 -0
  18. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/lib/model.py +14 -0
  19. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/setup_wizard.py +16 -1
  20. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/templates/config.example.yaml +4 -0
  21. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/ask_user.py +15 -9
  22. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/bash/jobs.py +61 -3
  23. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/create_agent_type.py +11 -3
  24. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/web_search.py +10 -0
  25. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff.egg-info/PKG-INFO +38 -13
  26. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff.egg-info/SOURCES.txt +2 -0
  27. {dostuff-0.2.15 → dostuff-0.2.16}/pyproject.toml +1 -1
  28. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_ask_user.py +8 -8
  29. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_capabilities.py +21 -2
  30. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_checkpoints_todos_caching.py +68 -1
  31. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_config_memory_mcp.py +7 -0
  32. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_create_agent_type.py +9 -0
  33. dostuff-0.2.16/tests/test_extras.py +100 -0
  34. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_jobs.py +18 -1
  35. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_loop.py +103 -4
  36. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_subagents_fork.py +40 -11
  37. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_subagents_run.py +89 -1
  38. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_subagents_types.py +174 -0
  39. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_tui.py +521 -12
  40. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_turn_context.py +29 -0
  41. dostuff-0.2.15/dostuff/agent/subagents/prompt.py +0 -57
  42. {dostuff-0.2.15 → dostuff-0.2.16}/LICENSE +0 -0
  43. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/__init__.py +0 -0
  44. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/__main__.py +0 -0
  45. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/agent/capabilities.py +0 -0
  46. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/agent/instructions.py +0 -0
  47. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/agent/permissions.py +0 -0
  48. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/agent/run_tool.py +0 -0
  49. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/agent/subagents/__init__.py +0 -0
  50. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/agent/subagents/adapter.py +0 -0
  51. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/cli.py +0 -0
  52. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/headless.py +0 -0
  53. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/append_step.py +0 -0
  54. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/attachments.py +0 -0
  55. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/clipboard.py +0 -0
  56. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/consume_stream.py +0 -0
  57. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/context_usage.py +0 -0
  58. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/convert_document.py +0 -0
  59. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/environment_context.py +0 -0
  60. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/file_mentions.py +0 -0
  61. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/get_model_token_limit.py +0 -0
  62. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/load_identity.py +0 -0
  63. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/load_project_instructions.py +0 -0
  64. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/loop_check_cancelled.py +0 -0
  65. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/loop_emit.py +0 -0
  66. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/manage_context.py +0 -0
  67. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/model_cost.py +0 -0
  68. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/notices.py +0 -0
  69. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/pastes.py +0 -0
  70. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/quick_memory.py +0 -0
  71. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/side_question.py +0 -0
  72. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/slash_suggestion.py +0 -0
  73. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/steering.py +0 -0
  74. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/tool_attachments.py +0 -0
  75. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/agent/turn_context.py +0 -0
  76. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/config_secrets.py +0 -0
  77. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/hooks/__init__.py +0 -0
  78. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/hooks/dispatch.py +0 -0
  79. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/hooks/events.py +0 -0
  80. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/hooks/load_hooks.py +0 -0
  81. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/hooks/run_hook.py +0 -0
  82. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/hooks/trust.py +0 -0
  83. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/mcp/load_mcp_config.py +0 -0
  84. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/mcp/mcp_oauth.py +0 -0
  85. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/mcp/server_config.py +0 -0
  86. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/mcp/token_store.py +0 -0
  87. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/memory/consolidate.py +0 -0
  88. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/memory/export_session.py +0 -0
  89. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/memory/repair_index.py +0 -0
  90. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/memory/resolve_memory_operation.py +0 -0
  91. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/memory/same_episode.py +0 -0
  92. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/memory/shell_step.py +0 -0
  93. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/models/add_model_entry.py +0 -0
  94. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/models/list_models.py +0 -0
  95. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/models/opencode.py +0 -0
  96. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/skills/custom_commands.py +0 -0
  97. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/skills/discover_skills.py +0 -0
  98. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/tools/diff.py +0 -0
  99. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/tools/generate_tool_schema.py +0 -0
  100. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/tools/project_root.py +0 -0
  101. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/tools/resolve_safe_path.py +0 -0
  102. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/ui/__init__.py +0 -0
  103. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/ui/ask_answers.py +0 -0
  104. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/ui/emit.py +0 -0
  105. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/ui/prompt_history.py +0 -0
  106. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/helpers/ui/terminal_signals.py +0 -0
  107. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/lib/checkpoints.py +0 -0
  108. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/lib/exceptions.py +0 -0
  109. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/lib/mcp/mcp_client.py +0 -0
  110. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/lib/mcp/mcp_client_registration_store.py +0 -0
  111. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/lib/mcp/mcp_tool_registry_store.py +0 -0
  112. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/lib/memory/backend.py +0 -0
  113. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/lib/memory/chroma.py +0 -0
  114. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/lib/memory/episodic_memory_store.py +0 -0
  115. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/lib/memory/hybrid_memory_store.py +0 -0
  116. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/lib/memory/migrate.py +0 -0
  117. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/lib/memory/safe_query.py +0 -0
  118. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/lib/memory/semantic_memory_store.py +0 -0
  119. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/lib/memory/session_store.py +0 -0
  120. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/lib/memory/sqlite_memory_store.py +0 -0
  121. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/lib/memory/stores.py +0 -0
  122. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/lib/memory/types.py +0 -0
  123. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/lib/tracing.py +0 -0
  124. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/lib/worktree.py +0 -0
  125. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/memory/__init__.py +0 -0
  126. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/skills.py +0 -0
  127. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/templates/env.example +0 -0
  128. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/__init__.py +0 -0
  129. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/agent.py +0 -0
  130. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/bash/bash_command.py +0 -0
  131. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/bash/bash_output.py +0 -0
  132. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/bash/kill_shell.py +0 -0
  133. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/definitions.py +0 -0
  134. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/files/delete_file.py +0 -0
  135. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/files/edit_file.py +0 -0
  136. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/files/list_files.py +0 -0
  137. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/files/multi_edit.py +0 -0
  138. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/files/read_file.py +0 -0
  139. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/files/write_file.py +0 -0
  140. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/get_current_datetime.py +0 -0
  141. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/mcp/call_mcp_tool.py +0 -0
  142. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/mcp/get_mcp_tool_details.py +0 -0
  143. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/mcp/search_mcp_tools.py +0 -0
  144. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/memory/save_episode.py +0 -0
  145. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/memory/save_memory.py +0 -0
  146. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/memory/search_memory.py +0 -0
  147. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/names.py +0 -0
  148. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/search/glob.py +0 -0
  149. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/search/grep.py +0 -0
  150. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/search/walk.py +0 -0
  151. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/send_message.py +0 -0
  152. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/settings.py +0 -0
  153. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/stop_agent.py +0 -0
  154. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/todo_write.py +0 -0
  155. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff/tools/web_fetch.py +0 -0
  156. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff.egg-info/dependency_links.txt +0 -0
  157. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff.egg-info/entry_points.txt +0 -0
  158. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff.egg-info/requires.txt +0 -0
  159. {dostuff-0.2.15 → dostuff-0.2.16}/dostuff.egg-info/top_level.txt +0 -0
  160. {dostuff-0.2.15 → dostuff-0.2.16}/setup.cfg +0 -0
  161. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_attachments.py +0 -0
  162. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_bash_command.py +0 -0
  163. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_cli_commands.py +0 -0
  164. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_episode_index.py +0 -0
  165. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_export_session.py +0 -0
  166. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_file_mentions.py +0 -0
  167. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_file_tools.py +0 -0
  168. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_hooks.py +0 -0
  169. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_mcp_e2e.py +0 -0
  170. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_mcp_env_references.py +0 -0
  171. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_mcp_oauth.py +0 -0
  172. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_memory_delivery.py +0 -0
  173. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_memory_fts5_fallback.py +0 -0
  174. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_memory_hybrid_store.py +0 -0
  175. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_memory_index_divergence.py +0 -0
  176. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_memory_index_repair.py +0 -0
  177. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_memory_migrate.py +0 -0
  178. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_memory_recall_eval.py +0 -0
  179. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_memory_sqlite_store.py +0 -0
  180. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_memory_store_scope.py +0 -0
  181. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_opencode.py +0 -0
  182. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_optional_memory_and_instructions.py +0 -0
  183. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_pastes.py +0 -0
  184. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_permissions.py +0 -0
  185. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_roadmap_021.py +0 -0
  186. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_search_memory.py +0 -0
  187. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_session_store.py +0 -0
  188. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_settings_tools.py +0 -0
  189. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_setup_wizard.py +0 -0
  190. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_side_question.py +0 -0
  191. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_side_question_litellm.py +0 -0
  192. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_skill_command.py +0 -0
  193. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_skills_discovery.py +0 -0
  194. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_slash_suggestion.py +0 -0
  195. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_steering.py +0 -0
  196. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_subagent.py +0 -0
  197. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_subagents_background.py +0 -0
  198. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_subagents_store.py +0 -0
  199. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_terminal_signals.py +0 -0
  200. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_tool_schemas.py +0 -0
  201. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_tools_listing.py +0 -0
  202. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_web_fetch.py +0 -0
  203. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_web_search.py +0 -0
  204. {dostuff-0.2.15 → dostuff-0.2.16}/tests/test_worktree.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: dostuff
3
- Version: 0.2.15
3
+ Version: 0.2.16
4
4
  Summary: DoStuff - a terminal coding agent for any LLM: TUI and headless mode, permissions, MCP, skills, web tools, sessions and git worktrees
5
5
  Author-email: Varun Kumawat <varunkumawatleap2@gmail.com>
6
6
  License-Expression: MIT
@@ -101,12 +101,13 @@ DoStuff is a terminal AI agent that runs anywhere `pip` runs. It gives you a ful
101
101
  - **Subagents** — the `agent` tool starts agents in parallel, in the foreground or the background, from built-in types (`explore`, `plan`, `general-purpose`), your own Markdown agent files (Claude Code's `.claude/agents/` work too) or a `fork` of the conversation; continue one with `send_message`, stop it with `stop_agent`, see them all in `/agents`. See [Subagents](#subagents)
102
102
  - **Per-tool timeout** (120s) to prevent hung servers; long tool output is truncated (head + tail) before it reaches the model
103
103
  - **Retries with backoff** for rate limits, timeouts and 5xx errors (6 by default, exponential with jitter, honors `Retry-After`; `loop.max_retries` / `loop.retry_max_delay`); auth / bad-request errors fail fast
104
+ - **Output-limit recovery** — a reply the provider stops at its output-token cap is never taken as the answer: the model is told it was cut off and continues (3 times in a row at most, then the turn ends with the text marked incomplete), and a tool call whose arguments were cut off is reported as such so the model retries it smaller. `loop.max_tokens` sets the cap for every model call, main agent and subagents (unset: the provider's default — on Anthropic-style routes, such as Claude or MiniMax through OpenCode Go, litellm then sends 4096 for models it doesn't know); an agent file's `max_tokens:` overrides it for that type, e.g. one that writes long files. If the provider rejects a cap above the model's limit, the error says which setting sent it
104
105
  - **Token and cost tracking** — per-turn and cumulative totals in `/status` and the line after each turn (`✻ Worked for 1m 5s · $0.01`); cost in USD from litellm's price table (hidden when the model has no known price). The table bundled with litellm is used, so startup doesn't wait on a download; set `LITELLM_LOCAL_MODEL_COST_MAP=False` to fetch the latest one from GitHub instead
105
106
  - **Long-term memory tools** — the agent saves facts (`save_memory`, about you or about this project) and notable moments (`save_episode`) as they come up; saved facts (up to 50, newest first) are shown to the agent in later sessions, episodes related to the prompt are recalled, the agent looks up older ones with `search_memory`, and `/memories consolidate` merges overlapping facts after showing you the change
106
107
  - **Graceful exit** — `Ctrl+Q` or `/exit` saves the session, cleans up, and stops background workers
107
108
  - **Clean Cancellation** — `Escape` can cancel in-flight agent turns cleanly without corrupting the session
108
109
  - **2-state session split** — `session_steps` (full audit) / `working_history` (LLM payload); DB persists both plus `compaction_notes` + `last_input_tokens`
109
- - **Auto & Manual Compaction** — Manual `/compact` runs compaction and saves it. Auto-compaction triggers automatically during the agent loop if context usage (`last_input_tokens`) exceeds `loop.auto_compact_threshold` (default 50%) of the model's token limit; `off` disables it (an overflowing window is still compacted), and `/compact auto <N|off>` changes it for the session. It keeps at least 15% or 20k tokens of the most recent steps in the working history, summarizing the rest into `compaction_notes` which are appended to system instructions.
110
+ - **Auto & Manual Compaction** — Manual `/compact` runs compaction and saves it. Auto-compaction triggers automatically during the agent loop if context usage (`last_input_tokens`) exceeds `loop.auto_compact_threshold` (default 50%) of the model's token limit; `off` disables it (an overflowing window is still compacted), and `/compact auto <N|off>` changes it for the session. It keeps at least 15% or 20k tokens of the most recent steps in the working history, summarizing the rest into `compaction_notes` which are appended to system instructions. Each subagent compacts its own history at the same percent of its own model's window, unless `agents.compact_threshold` or the agent file's `compact_threshold:` sets another (`/agents types <name>` shows which applies).
110
111
  - **Tracing (opt-in)** — OTLP tracing support built into `lib/tracing.py`; prompt and tool content are redacted from spans by default
111
112
 
112
113
  ---
@@ -135,7 +136,8 @@ Optional features come as extras:
135
136
 
136
137
  Extras combine, e.g. `pip install "dostuff[memory,search]"`. Without `memory` everything else
137
138
  works: the memory tools are hidden from the model and MCP tool search matches keywords instead of
138
- meaning. `dostuff doctor` shows whether memory is on.
139
+ meaning. `dostuff doctor` lists every extra, installed or not, with the command that adds it; `dostuff setup`
140
+ ends by naming the ones you don't have, and `/tools` says what each missing one changes about the tools.
139
141
 
140
142
  ### Other install methods
141
143
 
@@ -210,7 +212,7 @@ In the TUI:
210
212
  | `dostuff init [--force]` | Create `.dostuff/` config/skills in current dir (won't overwrite without `--force`) |
211
213
  | `dostuff setup` | Pick a model, save its API key, write `~/.dostuff/config.yaml` (runs automatically on first launch) |
212
214
  | `dostuff config` | Show resolved config paths and values |
213
- | `dostuff doctor` | Health check: config, API key, MCP, data dir; prints a fix for each problem |
215
+ | `dostuff doctor` | Health check: config, API key, MCP, data dir, memory and the optional extras; prints a fix for each problem |
214
216
  | `dostuff memory [check\|repair\|consolidate] [-y]` | Check that long-term memory's indexes match what is saved (`check`, the default): the keyword index, and on the default backend the embedding index (memories not indexed, out of date, or forgotten but still indexed). `repair` fixes what `check` found, rebuilding either index from `memory.db`, which it never changes, so nothing saved is lost. On `memory.backend: chroma` it rebuilds a broken Chroma index after "Error finding id" errors, backing it up to `~/.dostuff/data/chroma-backups/` first. Stop dostuff before repairing. `consolidate` asks the model to merge your overlapping saved facts and this project's, shows the change, and writes it only when you say yes (`-y` skips the question; in auto mode it refuses without `-y`) |
215
217
  | `dostuff resume [<id>]` | Resume the latest session started in the current directory (or the given one; a unique ID prefix is enough). `--fork` resumes a copy, `--worktree` moves it into a new worktree |
216
218
  | `dostuff sessions [--all] [-n N]` | List sessions in the current directory with their title or first prompt (`--all`: every directory) |
@@ -243,7 +245,7 @@ In the TUI:
243
245
  | `Up` / `Down` | On the first / last line of the input: previous / next prompt typed in this directory (saved in `~/.dostuff/data/prompt_history.jsonl`) |
244
246
  | `Ctrl+R` | Search the prompts typed in this directory (type to filter, `Enter` puts the prompt in the input) |
245
247
  | `Esc` `Esc` | With an empty input: take back your last prompt. It and everything after it (answer, tool calls) leave the conversation and the prompt goes back in the input to edit and resend. Files that turn changed stay as they are; `/undo` restores them |
246
- | `Ctrl+O` | Expand / collapse every truncated tool and shell result (click one to toggle just that one) |
248
+ | `Ctrl+O` | Expand / collapse every tool-call line and truncated shell result, with tool output in full (click one to open just that one, with a preview of each result; click a call in it for that result in full) |
247
249
  | `Ctrl+B` | While the agent waits on a shell command or a foreground subagent (the loader says `Ctrl+B to background`): move them to the background; the agent gets what a command printed so far and carries on, and hears from the agent when it ends. Not for `!command`s. See [Background jobs](#background-jobs) and [Subagents](#subagents) |
248
250
  | `Shift+Tab` | Cycle the permission mode for this session: ask → auto → plan → allowlist (shown in the status bar) |
249
251
  | `Ctrl+Backspace` / `Ctrl+W` / `Alt+Backspace` | Delete the previous word; `Ctrl+Delete` / `Alt+Delete` the next one |
@@ -251,21 +253,22 @@ In the TUI:
251
253
  | `/skills` / `/skills reload` | The skills this session knows: each one's folder, and which are manual only / re-read them now and rebuild the system prompt (reports what was added and removed). See [Skills](#skills) |
252
254
  | `/exit` | Save the session and quit |
253
255
  | `/clear` | Start a new session; the old one stays resumable |
254
- | `/resume [<id>]` | Pick another session from this directory (or switch to the given one) |
256
+ | `/resume [<id>]` | Pick another session from this directory (or switch to the given one). A long session shows its last 60 steps under an `↑ N earlier steps` line; scroll to the top or click the line to load older ones |
255
257
  | `/fork [title] [--worktree]` | Copy this session into a new one and switch to it; the original is unchanged |
256
258
  | `/worktree [name]` / `/worktree exit` | Move the session into a new git worktree on branch `dostuff/<name>` / leave it (removed if unchanged, otherwise keep or remove) |
257
259
  | `/permissions [mode]` | Show or change the permission mode for this session (`ask`, `allowlist`, `auto`, `plan`) |
258
260
  | `/copy` | Copy the model's last answer to the clipboard |
259
261
  | `/btw <question>` | Ask a side question about the conversation, even while a turn runs: answered in a panel above the input, without tools, never added to the history. See [Side questions](#side-questions-btw) |
260
262
  | `/steer <message>` | Send a correction to the running turn: the model reads it at the next tool boundary and carries on, without the turn ending. See [Mid-turn steering](#mid-turn-steering-steer) |
263
+ | `/thinking [level]` | Set how hard the model thinks for this session: `auto` (the provider's default), `off`, `minimal`, `low`, `medium` or `high`; models without reasoning ignore it (default from `loop.reasoning_effort`) |
261
264
  | `/notifications [on\|off\|bell\|osc9]` | Turn turn-finished / approval notifications on or off for this session (default from `ui.notifications`) |
262
265
  | `/model [<provider/model>] [--active]` | Pick a model: your saved ones (`models:` in config.yaml) first, then "More <provider> models…" for each provider's list (type to filter; Enter on no match uses what you typed). A model that isn't saved yet is added to `~/.dostuff/config.yaml`. A plain `/model` switch lasts only for this session; add `--active` (e.g. `/model --active`, or `/model anthropic/claude-sonnet-5-5 --active`) to make it the default that new sessions start with |
263
266
  | `/config [mcp] [project]` | Edit a settings file right in the TUI: pick `config.yaml` or the MCP servers, user (`~/.dostuff`) or project (`./.dostuff`), or name one (`/config mcp project`). `Ctrl+S` checks the file, saves it and applies it without a restart (an invalid file stays open with the error); `Esc` closes, twice if there are unsaved changes. A new file starts with every option commented out. `.env` files aren't offered |
264
267
  | `/status` | Session, directory, model, permission mode, tokens, context use, MCP servers |
265
268
  | `/context` | What fills the context window: system prompt, turn context (the environment and hook context sent with the prompts), memory (the saved facts and recalled episodes the model is shown; listed once any are), tools, MCP tools, project instructions, compaction summary and messages, with tokens, % and a bar |
266
269
  | `/memory [project\|global]` | Edit `AGENTS.md` (this project's or `~/.dostuff/AGENTS.md`) in the same editor as `/config`; `Ctrl+S` saves and the agent follows it from the next message |
267
- | `/doctor` | The `dostuff doctor` checks (config, API key, MCP config, memory, hooks), with a fix for each problem |
268
- | `/tools` | Every tool the agent has: when it asks (in `ask` mode), whether subagents get it and what it does, then each connected MCP server's tools (reached through `call_mcp_tool`) |
270
+ | `/doctor` | The `dostuff doctor` checks (config, API key, MCP config, memory, optional extras, hooks), with a fix for each problem |
271
+ | `/tools` | Every tool the agent has: when it asks (in `ask` mode), whether subagents get it and what it does, then what each missing optional extra changes, then each connected MCP server's tools (reached through `call_mcp_tool`) |
269
272
  | `/hooks [r]` | List the configured hooks per event: file, matcher, timeout, `fail_closed`, and whether each runs (`user` / `trusted` / `untrusted` / `disabled` / `broken`). `/hooks r` re-reads the config files. See [Hooks](#hooks) |
270
273
  | `/queue` / `/queue clear` | List the prompts waiting for the current turn: edit one (back into the input), run it next or remove it / drop them all |
271
274
  | `/jobs [<id>]` / `/jobs kill <id>` | List this session's background jobs (id, owner, status, runtime, command) / show a job's last 40 lines of output and its log files / stop one (the agent is told). See [Background jobs](#background-jobs) |
@@ -285,7 +288,12 @@ In the TUI:
285
288
 
286
289
  **Visual elements:**
287
290
 
288
- - **Messages** — `>` for your prompts (on a grey band), `●` for agent replies and tool calls, `⎿` for tool results; the terminal background shows through
291
+ - **Messages** — `>` for your prompts (on a grey band), `●` for agent replies, `⎿` for tool and shell output; the terminal background shows through
292
+ - **Tool calls** — a run of calls with nothing between them is one line, such as `● Read 2 files, ran 1 shell command`
293
+ (`Reading…` while they run, `· 1 failed` in red when one returned an error). Click it to see each call on its own
294
+ `●` line (blue while it runs, red when it failed) with the start of its result; click a call to see its whole result,
295
+ and again for the start only. `Ctrl+O` opens them all in full. Plans (`todo_write`), `ask_user` questions and
296
+ subagents keep their own `●` line, and file edits still show their diff
289
297
  - **Sticky prompt** — once a prompt or `!command` scrolls off the top, it stays pinned there on one row while you are in its turn, as the answer streams or when you scroll back through an old one, until the next prompt reaches the top. Click it to go back to the start of the turn; `↓ Jump to bottom` returns you to the latest message
290
298
  - **Approvals** — a selector (arrows, a number, or `y` = allow once, `a` = always this session, `n` = deny with an optional note); several calls in one response can be approved together
291
299
  - **Turn summary** — `✻ Worked for 1m 5s · $0.01 · done 12:59 PM` after each turn
@@ -313,7 +321,7 @@ In the TUI:
313
321
  | `bash_command` | shell | yes, unless every part of the command is on the read-only allow-list (`ls`, `cat`, `git status`, `git diff`, …) with no redirection or substitution |
314
322
  | `call_mcp_tool` | mcp | yes |
315
323
  | `web_fetch` | network | yes; `a` (always) allows that domain for the session |
316
- | `web_search` | network | yes; `a` (always) allows every search for the session. Free: DuckDuckGo by default, the `ddgs` package if installed (`pip install "dostuff[search]"`), or your own SearXNG via `search.searxng_url` |
324
+ | `web_search` | network | yes; `a` (always) allows every search for the session. Free: DuckDuckGo by default, the `ddgs` package if installed (`pip install "dostuff[search]"`), or your own SearXNG via `search.searxng_url`. The first search that falls back to DuckDuckGo's HTML page says so once in the TUI |
317
325
  | `agent`, `send_message`, `stop_agent` | — | no; each subagent's own calls ask, titled with the agent |
318
326
  | `ask_user` | read | never (it is the agent talking to you; subagents never get it) |
319
327
  | `save_memory`, `save_episode`, `search_memory` | read | never (each save is shown in the TUI; only with the `memory` extra; subagents never get them) |
@@ -477,8 +485,12 @@ every question has an answer, then it brightens and the parenthetical hint goes
477
485
  in the tab strip; **Enter** (or `o`) on it takes the input, and `←`/`Tab` still move between questions — so
478
486
  landing on a free-text question never traps you in the input. A call where *every* question is free text skips
479
487
  the panel entirely and the input takes each answer in turn, with the last Enter as the submission.
480
- - **Esc** cancels the questions and ends the turn, like Esc on an approval prompt. **Ctrl+Q** / `/exit` with a
488
+ - **Esc** while typing an `Other` answer goes back to the options, recording nothing and keeping the answers you
489
+ already gave. Esc on the options cancels the questions and ends the turn, like Esc on an approval prompt (in a
490
+ call with no panel, where every question is free text, Esc in the input cancels). **Ctrl+Q** / `/exit` with a
481
491
  question open cancel it first and then quit.
492
+ - Long labels and descriptions wrap in full rather than being cut, but the model is told to keep each part short:
493
+ the question one sentence, a label 1-5 words, a description about 15 words at most.
482
494
  - Up to 4 questions per call. The prompt tells the model when to ask: when the answer changes what it builds and
483
495
  the repo can't tell it; never to confirm a plan, to ask permission, or for anything `grep` / `read_file` answers.
484
496
 
@@ -667,7 +679,7 @@ A fork already has them in the conversation it inherits.
667
679
  | `general-purpose` | every subagent tool | research and multi-step tasks, including changing files. The default |
668
680
  | `explore` | read-only (its `bash_command` only runs read-only commands) | finding code and answering where things are; model: `agents.explore_model` |
669
681
  | `plan` | read-only | investigating and returning a step-by-step plan |
670
- | `fork` | the main agent's | a copy of the main agent that inherits the whole conversation (same system prompt, so a Claude model reuses the prompt cache). Costly: only when the task needs the conversation. Always the main model |
682
+ | `fork` | the main agent's list; the ones no subagent gets (starting or messaging agents, memory, todos, `ask_user`, settings) are refused when called | a copy of the main agent that inherits the whole conversation (same system prompt and tool list, so on a Claude model its first call reads the conversation from the prompt cache). Costly: only when the task needs the conversation. Always the main model |
671
683
 
672
684
  Your own types are Markdown files with YAML frontmatter. They are searched in this order, and the first file with a
673
685
  given `name` wins: `.dostuff/agents/` and `.claude/agents/` in the project, then `~/.dostuff/agents/` and
@@ -677,7 +689,7 @@ agent before its next model call (see [Adding skills mid-session](#adding-skills
677
689
  `/agents reload` re-reads them now and rebuilds the system prompt.
678
690
 
679
691
  You can also ask the agent for one ("make a code-reviewer agent"): its `create_agent_type(name, description, prompt,
680
- tools, model, max_iterations, scope, replace)` tool writes the file to `.dostuff/agents/` (`scope="user"`:
692
+ tools, model, max_iterations, max_tokens, scope, replace)` tool writes the file to `.dostuff/agents/` (`scope="user"`:
681
693
  `~/.dostuff/agents/`) after showing it to you. Like the settings tools, it asks in every mode. The new type can be
682
694
  started at once, and the agent is told about it before its next step.
683
695
 
@@ -688,11 +700,21 @@ description: Reviews a diff for bugs and missing tests. Use after a change.
688
700
  tools: Read, Grep, Glob, Bash # omit for every subagent tool
689
701
  model: fast # inherit (default), an alias from agents.models, or a litellm model string
690
702
  max_iterations: 30 # optional; default agents.max_iterations
703
+ max_tokens: 32000 # optional; output-token cap per model call, default loop.max_tokens
704
+ compact_threshold: 30 # optional; auto-compact at this % of its window (1-100 or off), default agents.compact_threshold
691
705
  omit_memory: true # optional; leave out your saved facts (default false)
706
+ skills: code-style, testing # optional; these skills' instructions go into its system prompt
692
707
  ---
693
708
  You are a code reviewer. Report findings as a list, most severe first.
694
709
  ```
695
710
 
711
+ `skills:` (a list, or names separated by commas) puts each named skill's `SKILL.md` instructions into the agent's
712
+ system prompt, after the type's own body, so the agent follows them without having to load them first. At most 32
713
+ skills and `agents.max_preload_chars` characters (default 60000) go in. A skill that isn't found, is manual-only or
714
+ can't be read is skipped, and so is everything after the first one that doesn't fit. The run's report starts with a
715
+ `[warning] Skills not preloaded: ...` line naming each skipped skill and the reason. `fork` has no type, so it
716
+ preloads nothing.
717
+
696
718
  `tools:` takes DoStuff names or Claude Code's, so Claude Code agent files work unchanged:
697
719
 
698
720
  | Claude Code | DoStuff |
@@ -748,6 +770,8 @@ agents:
748
770
  wake_on_end: true # a finished background agent resumes the idle TUI
749
771
  read_claude_agents: true # also load .claude/agents/
750
772
  explore_model: inherit # model of the built-in explore type
773
+ max_preload_chars: 60000 # most skill text an agent file's skills: puts in its system prompt
774
+ # compact_threshold: 30 # auto-compaction % for subagents (1-100 or off); default: the main agent's
751
775
  models: # aliases for model: and model=
752
776
  fast: anthropic/claude-haiku-5-5
753
777
  ```
@@ -990,6 +1014,7 @@ loop:
990
1014
  max_tool_output_chars: 30000 # longer tool results keep head + tail
991
1015
  max_retries: 6 # retries on rate limits, timeouts, 5xx (0 = none)
992
1016
  retry_max_delay: 60 # cap on each wait, seconds; Retry-After is honored
1017
+ # max_tokens: 16000 # output-token cap per model call (unset: the provider's default); keep it within the model's output limit
993
1018
 
994
1019
  memory:
995
1020
  backend: hybrid # hybrid (default) | sqlite (keywords only) | chroma (the store before hybrid)
@@ -46,12 +46,13 @@ DoStuff is a terminal AI agent that runs anywhere `pip` runs. It gives you a ful
46
46
  - **Subagents** — the `agent` tool starts agents in parallel, in the foreground or the background, from built-in types (`explore`, `plan`, `general-purpose`), your own Markdown agent files (Claude Code's `.claude/agents/` work too) or a `fork` of the conversation; continue one with `send_message`, stop it with `stop_agent`, see them all in `/agents`. See [Subagents](#subagents)
47
47
  - **Per-tool timeout** (120s) to prevent hung servers; long tool output is truncated (head + tail) before it reaches the model
48
48
  - **Retries with backoff** for rate limits, timeouts and 5xx errors (6 by default, exponential with jitter, honors `Retry-After`; `loop.max_retries` / `loop.retry_max_delay`); auth / bad-request errors fail fast
49
+ - **Output-limit recovery** — a reply the provider stops at its output-token cap is never taken as the answer: the model is told it was cut off and continues (3 times in a row at most, then the turn ends with the text marked incomplete), and a tool call whose arguments were cut off is reported as such so the model retries it smaller. `loop.max_tokens` sets the cap for every model call, main agent and subagents (unset: the provider's default — on Anthropic-style routes, such as Claude or MiniMax through OpenCode Go, litellm then sends 4096 for models it doesn't know); an agent file's `max_tokens:` overrides it for that type, e.g. one that writes long files. If the provider rejects a cap above the model's limit, the error says which setting sent it
49
50
  - **Token and cost tracking** — per-turn and cumulative totals in `/status` and the line after each turn (`✻ Worked for 1m 5s · $0.01`); cost in USD from litellm's price table (hidden when the model has no known price). The table bundled with litellm is used, so startup doesn't wait on a download; set `LITELLM_LOCAL_MODEL_COST_MAP=False` to fetch the latest one from GitHub instead
50
51
  - **Long-term memory tools** — the agent saves facts (`save_memory`, about you or about this project) and notable moments (`save_episode`) as they come up; saved facts (up to 50, newest first) are shown to the agent in later sessions, episodes related to the prompt are recalled, the agent looks up older ones with `search_memory`, and `/memories consolidate` merges overlapping facts after showing you the change
51
52
  - **Graceful exit** — `Ctrl+Q` or `/exit` saves the session, cleans up, and stops background workers
52
53
  - **Clean Cancellation** — `Escape` can cancel in-flight agent turns cleanly without corrupting the session
53
54
  - **2-state session split** — `session_steps` (full audit) / `working_history` (LLM payload); DB persists both plus `compaction_notes` + `last_input_tokens`
54
- - **Auto & Manual Compaction** — Manual `/compact` runs compaction and saves it. Auto-compaction triggers automatically during the agent loop if context usage (`last_input_tokens`) exceeds `loop.auto_compact_threshold` (default 50%) of the model's token limit; `off` disables it (an overflowing window is still compacted), and `/compact auto <N|off>` changes it for the session. It keeps at least 15% or 20k tokens of the most recent steps in the working history, summarizing the rest into `compaction_notes` which are appended to system instructions.
55
+ - **Auto & Manual Compaction** — Manual `/compact` runs compaction and saves it. Auto-compaction triggers automatically during the agent loop if context usage (`last_input_tokens`) exceeds `loop.auto_compact_threshold` (default 50%) of the model's token limit; `off` disables it (an overflowing window is still compacted), and `/compact auto <N|off>` changes it for the session. It keeps at least 15% or 20k tokens of the most recent steps in the working history, summarizing the rest into `compaction_notes` which are appended to system instructions. Each subagent compacts its own history at the same percent of its own model's window, unless `agents.compact_threshold` or the agent file's `compact_threshold:` sets another (`/agents types <name>` shows which applies).
55
56
  - **Tracing (opt-in)** — OTLP tracing support built into `lib/tracing.py`; prompt and tool content are redacted from spans by default
56
57
 
57
58
  ---
@@ -80,7 +81,8 @@ Optional features come as extras:
80
81
 
81
82
  Extras combine, e.g. `pip install "dostuff[memory,search]"`. Without `memory` everything else
82
83
  works: the memory tools are hidden from the model and MCP tool search matches keywords instead of
83
- meaning. `dostuff doctor` shows whether memory is on.
84
+ meaning. `dostuff doctor` lists every extra, installed or not, with the command that adds it; `dostuff setup`
85
+ ends by naming the ones you don't have, and `/tools` says what each missing one changes about the tools.
84
86
 
85
87
  ### Other install methods
86
88
 
@@ -155,7 +157,7 @@ In the TUI:
155
157
  | `dostuff init [--force]` | Create `.dostuff/` config/skills in current dir (won't overwrite without `--force`) |
156
158
  | `dostuff setup` | Pick a model, save its API key, write `~/.dostuff/config.yaml` (runs automatically on first launch) |
157
159
  | `dostuff config` | Show resolved config paths and values |
158
- | `dostuff doctor` | Health check: config, API key, MCP, data dir; prints a fix for each problem |
160
+ | `dostuff doctor` | Health check: config, API key, MCP, data dir, memory and the optional extras; prints a fix for each problem |
159
161
  | `dostuff memory [check\|repair\|consolidate] [-y]` | Check that long-term memory's indexes match what is saved (`check`, the default): the keyword index, and on the default backend the embedding index (memories not indexed, out of date, or forgotten but still indexed). `repair` fixes what `check` found, rebuilding either index from `memory.db`, which it never changes, so nothing saved is lost. On `memory.backend: chroma` it rebuilds a broken Chroma index after "Error finding id" errors, backing it up to `~/.dostuff/data/chroma-backups/` first. Stop dostuff before repairing. `consolidate` asks the model to merge your overlapping saved facts and this project's, shows the change, and writes it only when you say yes (`-y` skips the question; in auto mode it refuses without `-y`) |
160
162
  | `dostuff resume [<id>]` | Resume the latest session started in the current directory (or the given one; a unique ID prefix is enough). `--fork` resumes a copy, `--worktree` moves it into a new worktree |
161
163
  | `dostuff sessions [--all] [-n N]` | List sessions in the current directory with their title or first prompt (`--all`: every directory) |
@@ -188,7 +190,7 @@ In the TUI:
188
190
  | `Up` / `Down` | On the first / last line of the input: previous / next prompt typed in this directory (saved in `~/.dostuff/data/prompt_history.jsonl`) |
189
191
  | `Ctrl+R` | Search the prompts typed in this directory (type to filter, `Enter` puts the prompt in the input) |
190
192
  | `Esc` `Esc` | With an empty input: take back your last prompt. It and everything after it (answer, tool calls) leave the conversation and the prompt goes back in the input to edit and resend. Files that turn changed stay as they are; `/undo` restores them |
191
- | `Ctrl+O` | Expand / collapse every truncated tool and shell result (click one to toggle just that one) |
193
+ | `Ctrl+O` | Expand / collapse every tool-call line and truncated shell result, with tool output in full (click one to open just that one, with a preview of each result; click a call in it for that result in full) |
192
194
  | `Ctrl+B` | While the agent waits on a shell command or a foreground subagent (the loader says `Ctrl+B to background`): move them to the background; the agent gets what a command printed so far and carries on, and hears from the agent when it ends. Not for `!command`s. See [Background jobs](#background-jobs) and [Subagents](#subagents) |
193
195
  | `Shift+Tab` | Cycle the permission mode for this session: ask → auto → plan → allowlist (shown in the status bar) |
194
196
  | `Ctrl+Backspace` / `Ctrl+W` / `Alt+Backspace` | Delete the previous word; `Ctrl+Delete` / `Alt+Delete` the next one |
@@ -196,21 +198,22 @@ In the TUI:
196
198
  | `/skills` / `/skills reload` | The skills this session knows: each one's folder, and which are manual only / re-read them now and rebuild the system prompt (reports what was added and removed). See [Skills](#skills) |
197
199
  | `/exit` | Save the session and quit |
198
200
  | `/clear` | Start a new session; the old one stays resumable |
199
- | `/resume [<id>]` | Pick another session from this directory (or switch to the given one) |
201
+ | `/resume [<id>]` | Pick another session from this directory (or switch to the given one). A long session shows its last 60 steps under an `↑ N earlier steps` line; scroll to the top or click the line to load older ones |
200
202
  | `/fork [title] [--worktree]` | Copy this session into a new one and switch to it; the original is unchanged |
201
203
  | `/worktree [name]` / `/worktree exit` | Move the session into a new git worktree on branch `dostuff/<name>` / leave it (removed if unchanged, otherwise keep or remove) |
202
204
  | `/permissions [mode]` | Show or change the permission mode for this session (`ask`, `allowlist`, `auto`, `plan`) |
203
205
  | `/copy` | Copy the model's last answer to the clipboard |
204
206
  | `/btw <question>` | Ask a side question about the conversation, even while a turn runs: answered in a panel above the input, without tools, never added to the history. See [Side questions](#side-questions-btw) |
205
207
  | `/steer <message>` | Send a correction to the running turn: the model reads it at the next tool boundary and carries on, without the turn ending. See [Mid-turn steering](#mid-turn-steering-steer) |
208
+ | `/thinking [level]` | Set how hard the model thinks for this session: `auto` (the provider's default), `off`, `minimal`, `low`, `medium` or `high`; models without reasoning ignore it (default from `loop.reasoning_effort`) |
206
209
  | `/notifications [on\|off\|bell\|osc9]` | Turn turn-finished / approval notifications on or off for this session (default from `ui.notifications`) |
207
210
  | `/model [<provider/model>] [--active]` | Pick a model: your saved ones (`models:` in config.yaml) first, then "More <provider> models…" for each provider's list (type to filter; Enter on no match uses what you typed). A model that isn't saved yet is added to `~/.dostuff/config.yaml`. A plain `/model` switch lasts only for this session; add `--active` (e.g. `/model --active`, or `/model anthropic/claude-sonnet-5-5 --active`) to make it the default that new sessions start with |
208
211
  | `/config [mcp] [project]` | Edit a settings file right in the TUI: pick `config.yaml` or the MCP servers, user (`~/.dostuff`) or project (`./.dostuff`), or name one (`/config mcp project`). `Ctrl+S` checks the file, saves it and applies it without a restart (an invalid file stays open with the error); `Esc` closes, twice if there are unsaved changes. A new file starts with every option commented out. `.env` files aren't offered |
209
212
  | `/status` | Session, directory, model, permission mode, tokens, context use, MCP servers |
210
213
  | `/context` | What fills the context window: system prompt, turn context (the environment and hook context sent with the prompts), memory (the saved facts and recalled episodes the model is shown; listed once any are), tools, MCP tools, project instructions, compaction summary and messages, with tokens, % and a bar |
211
214
  | `/memory [project\|global]` | Edit `AGENTS.md` (this project's or `~/.dostuff/AGENTS.md`) in the same editor as `/config`; `Ctrl+S` saves and the agent follows it from the next message |
212
- | `/doctor` | The `dostuff doctor` checks (config, API key, MCP config, memory, hooks), with a fix for each problem |
213
- | `/tools` | Every tool the agent has: when it asks (in `ask` mode), whether subagents get it and what it does, then each connected MCP server's tools (reached through `call_mcp_tool`) |
215
+ | `/doctor` | The `dostuff doctor` checks (config, API key, MCP config, memory, optional extras, hooks), with a fix for each problem |
216
+ | `/tools` | Every tool the agent has: when it asks (in `ask` mode), whether subagents get it and what it does, then what each missing optional extra changes, then each connected MCP server's tools (reached through `call_mcp_tool`) |
214
217
  | `/hooks [r]` | List the configured hooks per event: file, matcher, timeout, `fail_closed`, and whether each runs (`user` / `trusted` / `untrusted` / `disabled` / `broken`). `/hooks r` re-reads the config files. See [Hooks](#hooks) |
215
218
  | `/queue` / `/queue clear` | List the prompts waiting for the current turn: edit one (back into the input), run it next or remove it / drop them all |
216
219
  | `/jobs [<id>]` / `/jobs kill <id>` | List this session's background jobs (id, owner, status, runtime, command) / show a job's last 40 lines of output and its log files / stop one (the agent is told). See [Background jobs](#background-jobs) |
@@ -230,7 +233,12 @@ In the TUI:
230
233
 
231
234
  **Visual elements:**
232
235
 
233
- - **Messages** — `>` for your prompts (on a grey band), `●` for agent replies and tool calls, `⎿` for tool results; the terminal background shows through
236
+ - **Messages** — `>` for your prompts (on a grey band), `●` for agent replies, `⎿` for tool and shell output; the terminal background shows through
237
+ - **Tool calls** — a run of calls with nothing between them is one line, such as `● Read 2 files, ran 1 shell command`
238
+ (`Reading…` while they run, `· 1 failed` in red when one returned an error). Click it to see each call on its own
239
+ `●` line (blue while it runs, red when it failed) with the start of its result; click a call to see its whole result,
240
+ and again for the start only. `Ctrl+O` opens them all in full. Plans (`todo_write`), `ask_user` questions and
241
+ subagents keep their own `●` line, and file edits still show their diff
234
242
  - **Sticky prompt** — once a prompt or `!command` scrolls off the top, it stays pinned there on one row while you are in its turn, as the answer streams or when you scroll back through an old one, until the next prompt reaches the top. Click it to go back to the start of the turn; `↓ Jump to bottom` returns you to the latest message
235
243
  - **Approvals** — a selector (arrows, a number, or `y` = allow once, `a` = always this session, `n` = deny with an optional note); several calls in one response can be approved together
236
244
  - **Turn summary** — `✻ Worked for 1m 5s · $0.01 · done 12:59 PM` after each turn
@@ -258,7 +266,7 @@ In the TUI:
258
266
  | `bash_command` | shell | yes, unless every part of the command is on the read-only allow-list (`ls`, `cat`, `git status`, `git diff`, …) with no redirection or substitution |
259
267
  | `call_mcp_tool` | mcp | yes |
260
268
  | `web_fetch` | network | yes; `a` (always) allows that domain for the session |
261
- | `web_search` | network | yes; `a` (always) allows every search for the session. Free: DuckDuckGo by default, the `ddgs` package if installed (`pip install "dostuff[search]"`), or your own SearXNG via `search.searxng_url` |
269
+ | `web_search` | network | yes; `a` (always) allows every search for the session. Free: DuckDuckGo by default, the `ddgs` package if installed (`pip install "dostuff[search]"`), or your own SearXNG via `search.searxng_url`. The first search that falls back to DuckDuckGo's HTML page says so once in the TUI |
262
270
  | `agent`, `send_message`, `stop_agent` | — | no; each subagent's own calls ask, titled with the agent |
263
271
  | `ask_user` | read | never (it is the agent talking to you; subagents never get it) |
264
272
  | `save_memory`, `save_episode`, `search_memory` | read | never (each save is shown in the TUI; only with the `memory` extra; subagents never get them) |
@@ -422,8 +430,12 @@ every question has an answer, then it brightens and the parenthetical hint goes
422
430
  in the tab strip; **Enter** (or `o`) on it takes the input, and `←`/`Tab` still move between questions — so
423
431
  landing on a free-text question never traps you in the input. A call where *every* question is free text skips
424
432
  the panel entirely and the input takes each answer in turn, with the last Enter as the submission.
425
- - **Esc** cancels the questions and ends the turn, like Esc on an approval prompt. **Ctrl+Q** / `/exit` with a
433
+ - **Esc** while typing an `Other` answer goes back to the options, recording nothing and keeping the answers you
434
+ already gave. Esc on the options cancels the questions and ends the turn, like Esc on an approval prompt (in a
435
+ call with no panel, where every question is free text, Esc in the input cancels). **Ctrl+Q** / `/exit` with a
426
436
  question open cancel it first and then quit.
437
+ - Long labels and descriptions wrap in full rather than being cut, but the model is told to keep each part short:
438
+ the question one sentence, a label 1-5 words, a description about 15 words at most.
427
439
  - Up to 4 questions per call. The prompt tells the model when to ask: when the answer changes what it builds and
428
440
  the repo can't tell it; never to confirm a plan, to ask permission, or for anything `grep` / `read_file` answers.
429
441
 
@@ -612,7 +624,7 @@ A fork already has them in the conversation it inherits.
612
624
  | `general-purpose` | every subagent tool | research and multi-step tasks, including changing files. The default |
613
625
  | `explore` | read-only (its `bash_command` only runs read-only commands) | finding code and answering where things are; model: `agents.explore_model` |
614
626
  | `plan` | read-only | investigating and returning a step-by-step plan |
615
- | `fork` | the main agent's | a copy of the main agent that inherits the whole conversation (same system prompt, so a Claude model reuses the prompt cache). Costly: only when the task needs the conversation. Always the main model |
627
+ | `fork` | the main agent's list; the ones no subagent gets (starting or messaging agents, memory, todos, `ask_user`, settings) are refused when called | a copy of the main agent that inherits the whole conversation (same system prompt and tool list, so on a Claude model its first call reads the conversation from the prompt cache). Costly: only when the task needs the conversation. Always the main model |
616
628
 
617
629
  Your own types are Markdown files with YAML frontmatter. They are searched in this order, and the first file with a
618
630
  given `name` wins: `.dostuff/agents/` and `.claude/agents/` in the project, then `~/.dostuff/agents/` and
@@ -622,7 +634,7 @@ agent before its next model call (see [Adding skills mid-session](#adding-skills
622
634
  `/agents reload` re-reads them now and rebuilds the system prompt.
623
635
 
624
636
  You can also ask the agent for one ("make a code-reviewer agent"): its `create_agent_type(name, description, prompt,
625
- tools, model, max_iterations, scope, replace)` tool writes the file to `.dostuff/agents/` (`scope="user"`:
637
+ tools, model, max_iterations, max_tokens, scope, replace)` tool writes the file to `.dostuff/agents/` (`scope="user"`:
626
638
  `~/.dostuff/agents/`) after showing it to you. Like the settings tools, it asks in every mode. The new type can be
627
639
  started at once, and the agent is told about it before its next step.
628
640
 
@@ -633,11 +645,21 @@ description: Reviews a diff for bugs and missing tests. Use after a change.
633
645
  tools: Read, Grep, Glob, Bash # omit for every subagent tool
634
646
  model: fast # inherit (default), an alias from agents.models, or a litellm model string
635
647
  max_iterations: 30 # optional; default agents.max_iterations
648
+ max_tokens: 32000 # optional; output-token cap per model call, default loop.max_tokens
649
+ compact_threshold: 30 # optional; auto-compact at this % of its window (1-100 or off), default agents.compact_threshold
636
650
  omit_memory: true # optional; leave out your saved facts (default false)
651
+ skills: code-style, testing # optional; these skills' instructions go into its system prompt
637
652
  ---
638
653
  You are a code reviewer. Report findings as a list, most severe first.
639
654
  ```
640
655
 
656
+ `skills:` (a list, or names separated by commas) puts each named skill's `SKILL.md` instructions into the agent's
657
+ system prompt, after the type's own body, so the agent follows them without having to load them first. At most 32
658
+ skills and `agents.max_preload_chars` characters (default 60000) go in. A skill that isn't found, is manual-only or
659
+ can't be read is skipped, and so is everything after the first one that doesn't fit. The run's report starts with a
660
+ `[warning] Skills not preloaded: ...` line naming each skipped skill and the reason. `fork` has no type, so it
661
+ preloads nothing.
662
+
641
663
  `tools:` takes DoStuff names or Claude Code's, so Claude Code agent files work unchanged:
642
664
 
643
665
  | Claude Code | DoStuff |
@@ -693,6 +715,8 @@ agents:
693
715
  wake_on_end: true # a finished background agent resumes the idle TUI
694
716
  read_claude_agents: true # also load .claude/agents/
695
717
  explore_model: inherit # model of the built-in explore type
718
+ max_preload_chars: 60000 # most skill text an agent file's skills: puts in its system prompt
719
+ # compact_threshold: 30 # auto-compaction % for subagents (1-100 or off); default: the main agent's
696
720
  models: # aliases for model: and model=
697
721
  fast: anthropic/claude-haiku-5-5
698
722
  ```
@@ -935,6 +959,7 @@ loop:
935
959
  max_tool_output_chars: 30000 # longer tool results keep head + tail
936
960
  max_retries: 6 # retries on rate limits, timeouts, 5xx (0 = none)
937
961
  retry_max_delay: 60 # cap on each wait, seconds; Retry-After is honored
962
+ # max_tokens: 16000 # output-token cap per model call (unset: the provider's default); keep it within the model's output limit
938
963
 
939
964
  memory:
940
965
  backend: hybrid # hybrid (default) | sqlite (keywords only) | chroma (the store before hybrid)
@@ -1,10 +1,10 @@
1
1
  from typing import Any
2
2
 
3
- import litellm
4
3
  from litellm import acompletion
4
+ from dostuff.config import get_config
5
5
  from dostuff.helpers.agent.attachments import content_text, hydrate
6
6
  from dostuff.tools.definitions import TOOL_SCHEMAS, default_tool_names
7
- from dostuff.lib.model import completion_kwargs, uses_explicit_prompt_caching
7
+ from dostuff.lib.model import completion_kwargs, current_max_tokens, supports_reasoning, uses_explicit_prompt_caching
8
8
  from dostuff.lib.tracing import content_attr, tracer
9
9
  from opentelemetry.trace import Status, StatusCode
10
10
 
@@ -30,11 +30,12 @@ CACHE_BREAKPOINTS: list[dict[str, Any]] = [
30
30
  ]
31
31
 
32
32
 
33
- def _supports_reasoning(model: str) -> bool:
34
- try:
35
- return bool(litellm.supports_reasoning(model=model))
36
- except Exception:
37
- return False
33
+ def request_max_tokens() -> tuple[int, str]:
34
+ """The output-token cap a model call sends, and the setting it came from (for error hints); 0 = none sent.
35
+ The running subagent type's own cap wins over loop.max_tokens (main agent, forks, untyped runs)."""
36
+ if own := current_max_tokens.get():
37
+ return own, "the agent type's max_tokens:"
38
+ return int(getattr(get_config(), "max_tokens", 0) or 0), "loop.max_tokens"
38
39
 
39
40
 
40
41
  def build_request_kwargs(stream: bool) -> dict[str, Any]:
@@ -44,7 +45,16 @@ def build_request_kwargs(stream: bool) -> dict[str, Any]:
44
45
  kwargs["stream"] = stream
45
46
  if stream:
46
47
  kwargs["stream_options"] = {"include_usage": True}
47
- if _supports_reasoning(kwargs["model"]) and kwargs["model"].startswith(("gemini/", "vertex_ai/")):
48
+ config = get_config()
49
+ max_tokens, _ = request_max_tokens()
50
+ if max_tokens:
51
+ kwargs["max_tokens"] = max_tokens # litellm maps it per provider (max_output_tokens on the Responses route)
52
+ effort = config.reasoning_effort
53
+ if effort != "auto" and supports_reasoning(kwargs["model"]):
54
+ # litellm maps this to each provider's own knob (Anthropic budget, Gemini thinking budget, OpenAI effort);
55
+ # "off" is its "none". For Gemini it also decides whether thoughts are streamed.
56
+ kwargs["reasoning_effort"] = "none" if effort == "off" else effort
57
+ elif supports_reasoning(kwargs["model"]) and kwargs["model"].startswith(("gemini/", "vertex_ai/")):
48
58
  # Ask Gemini to stream its thoughts (rendered as partial_thought)
49
59
  kwargs["thinking_config"] = {"include_thoughts": True}
50
60
  if uses_explicit_prompt_caching():
@@ -59,6 +69,16 @@ def _as_blocks(content: Any) -> list[Any]:
59
69
  return [{"type": "text", "text": content}] if content else []
60
70
 
61
71
 
72
+ def _is_blank(content: Any) -> bool:
73
+ """No text worth sending: None, "", whitespace, or a block list made only of such text blocks."""
74
+ if isinstance(content, list):
75
+ return all(isinstance(b, dict) and b.get("type") == "text" and not str(b.get("text") or "").strip()
76
+ for b in content)
77
+ if content is None or isinstance(content, str):
78
+ return not (content or "").strip()
79
+ return False
80
+
81
+
62
82
  def _join_user_content(first: Any, second: Any) -> Any:
63
83
  if isinstance(first, list) or isinstance(second, list):
64
84
  return _as_blocks(first) + _as_blocks(second) # an image block must survive, so no flattening to text
@@ -72,10 +92,17 @@ def provider_messages(steps: list[dict[str, Any]]) -> list[dict[str, Any]]:
72
92
  `meta` is dostuff's own (the turn-context marker), so it is dropped. Adjacent user steps become one message,
73
93
  because Perplexity and strict chat templates (vLLM's Gemma, Mistral) reject two in a row, and a turn's context
74
94
  step always sits right before its prompt. Same history, same result, so the cached prefix holds.
95
+
96
+ An assistant step that only calls tools goes out with `content: None`, not "": litellm turns an empty
97
+ text into a "[System: Empty message content sanitised ...]" block on Anthropic routes, which the model
98
+ then reads as its own words and starts repeating. Stored steps keep their "", so resumed sessions benefit too.
75
99
  """
76
100
  messages: list[dict[str, Any]] = []
77
101
  for step in steps:
78
102
  message = {k: v for k, v in step.items() if k != "meta"} if "meta" in step else step
103
+ if (message.get("role") == "assistant" and message.get("tool_calls") and message.get("content") is not None
104
+ and _is_blank(message["content"])):
105
+ message = {**message, "content": None}
79
106
  if messages and message.get("role") == "user" and messages[-1].get("role") == "user":
80
107
  messages[-1] = {**messages[-1], "content": _join_user_content(messages[-1].get("content"), message.get("content"))}
81
108
  else: