dostuff 0.2.13__tar.gz → 0.2.15__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.
- {dostuff-0.2.13 → dostuff-0.2.15}/PKG-INFO +92 -29
- {dostuff-0.2.13 → dostuff-0.2.15}/README.md +83 -27
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/agent/call_agent.py +18 -2
- dostuff-0.2.15/dostuff/agent/capabilities.py +163 -0
- dostuff-0.2.15/dostuff/agent/instructions.py +173 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/agent/loop.py +129 -9
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/agent/subagents/__init__.py +2 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/agent/subagents/definitions.py +7 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/agent/subagents/fork.py +3 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/agent/subagents/prompt.py +11 -7
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/agent/subagents/registry.py +12 -3
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/agent/subagents/run.py +13 -1
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/cli.py +221 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/cli_tui.py +494 -53
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/config.py +29 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/headless.py +40 -9
- dostuff-0.2.15/dostuff/helpers/agent/attachments.py +407 -0
- dostuff-0.2.15/dostuff/helpers/agent/clipboard.py +167 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/agent/constants.py +25 -11
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/agent/context_usage.py +26 -6
- dostuff-0.2.15/dostuff/helpers/agent/convert_document.py +189 -0
- dostuff-0.2.15/dostuff/helpers/agent/file_mentions.py +317 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/agent/manage_context.py +17 -5
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/agent/steering.py +5 -2
- dostuff-0.2.15/dostuff/helpers/agent/tool_attachments.py +87 -0
- dostuff-0.2.15/dostuff/helpers/agent/turn_context.py +334 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/hooks/events.py +9 -4
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/hooks/run_hook.py +1 -1
- dostuff-0.2.15/dostuff/helpers/memory/consolidate.py +131 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/memory/export_session.py +12 -1
- dostuff-0.2.15/dostuff/helpers/memory/repair_index.py +214 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/memory/resolve_memory_operation.py +9 -5
- dostuff-0.2.15/dostuff/helpers/memory/same_episode.py +33 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/skills/discover_skills.py +45 -10
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/ui/doctor.py +16 -2
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/ui/tools_listing.py +1 -1
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/lib/mcp/mcp_tool_registry_store.py +5 -6
- dostuff-0.2.15/dostuff/lib/memory/backend.py +55 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/lib/memory/chroma.py +15 -0
- dostuff-0.2.15/dostuff/lib/memory/episodic_memory_store.py +266 -0
- dostuff-0.2.15/dostuff/lib/memory/hybrid_memory_store.py +391 -0
- dostuff-0.2.15/dostuff/lib/memory/migrate.py +118 -0
- dostuff-0.2.15/dostuff/lib/memory/safe_query.py +141 -0
- dostuff-0.2.15/dostuff/lib/memory/semantic_memory_store.py +143 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/lib/memory/session_store.py +4 -0
- dostuff-0.2.15/dostuff/lib/memory/sqlite_memory_store.py +562 -0
- dostuff-0.2.15/dostuff/lib/memory/stores.py +145 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/lib/model.py +17 -1
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/templates/config.example.yaml +5 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/agent.py +3 -2
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/definitions.py +7 -4
- dostuff-0.2.15/dostuff/tools/files/read_file.py +80 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/mcp/call_mcp_tool.py +28 -2
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/memory/save_episode.py +28 -8
- dostuff-0.2.15/dostuff/tools/memory/save_memory.py +54 -0
- dostuff-0.2.15/dostuff/tools/memory/search_memory.py +141 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/names.py +1 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff.egg-info/PKG-INFO +92 -29
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff.egg-info/SOURCES.txt +27 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff.egg-info/requires.txt +10 -1
- {dostuff-0.2.13 → dostuff-0.2.15}/pyproject.toml +17 -2
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_ask_user.py +1 -1
- dostuff-0.2.15/tests/test_attachments.py +1122 -0
- dostuff-0.2.15/tests/test_capabilities.py +528 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_cli_commands.py +114 -2
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_config_memory_mcp.py +168 -11
- dostuff-0.2.15/tests/test_episode_index.py +113 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_hooks.py +44 -2
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_loop.py +389 -0
- dostuff-0.2.15/tests/test_memory_delivery.py +552 -0
- dostuff-0.2.15/tests/test_memory_fts5_fallback.py +123 -0
- dostuff-0.2.15/tests/test_memory_hybrid_store.py +227 -0
- dostuff-0.2.15/tests/test_memory_index_divergence.py +262 -0
- dostuff-0.2.15/tests/test_memory_index_repair.py +162 -0
- dostuff-0.2.15/tests/test_memory_migrate.py +273 -0
- dostuff-0.2.15/tests/test_memory_recall_eval.py +376 -0
- dostuff-0.2.15/tests/test_memory_sqlite_store.py +174 -0
- dostuff-0.2.15/tests/test_memory_store_scope.py +502 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_optional_memory_and_instructions.py +39 -15
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_roadmap_021.py +21 -0
- dostuff-0.2.15/tests/test_search_memory.py +322 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_subagents_background.py +1 -1
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_subagents_fork.py +1 -1
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_subagents_run.py +37 -2
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_subagents_store.py +1 -1
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_subagents_types.py +1 -1
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_tools_listing.py +1 -1
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_tui.py +1293 -27
- dostuff-0.2.15/tests/test_turn_context.py +384 -0
- dostuff-0.2.13/dostuff/agent/instructions.py +0 -112
- dostuff-0.2.13/dostuff/helpers/agent/file_mentions.py +0 -182
- dostuff-0.2.13/dostuff/helpers/agent/turn_context.py +0 -58
- dostuff-0.2.13/dostuff/lib/memory/episodic_memory_store.py +0 -164
- dostuff-0.2.13/dostuff/lib/memory/semantic_memory_store.py +0 -80
- dostuff-0.2.13/dostuff/lib/memory/stores.py +0 -44
- dostuff-0.2.13/dostuff/tools/files/read_file.py +0 -46
- dostuff-0.2.13/dostuff/tools/memory/save_memory.py +0 -40
- dostuff-0.2.13/tests/test_turn_context.py +0 -197
- {dostuff-0.2.13 → dostuff-0.2.15}/LICENSE +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/__init__.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/__main__.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/agent/permissions.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/agent/run_tool.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/agent/subagents/adapter.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/agent/append_step.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/agent/consume_stream.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/agent/environment_context.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/agent/get_model_token_limit.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/agent/load_identity.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/agent/load_project_instructions.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/agent/loop_check_cancelled.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/agent/loop_emit.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/agent/model_cost.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/agent/notices.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/agent/pastes.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/agent/quick_memory.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/agent/side_question.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/agent/slash_suggestion.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/agent/tool_output.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/config_secrets.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/hooks/__init__.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/hooks/dispatch.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/hooks/load_hooks.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/hooks/trust.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/mcp/load_mcp_config.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/mcp/mcp_oauth.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/mcp/server_config.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/mcp/token_store.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/memory/shell_step.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/models/add_model_entry.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/models/list_models.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/models/opencode.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/skills/custom_commands.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/skills/skill_command.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/tools/diff.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/tools/generate_tool_schema.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/tools/project_root.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/tools/resolve_safe_path.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/ui/__init__.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/ui/ask_answers.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/ui/emit.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/ui/prompt_history.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/helpers/ui/terminal_signals.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/lib/checkpoints.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/lib/exceptions.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/lib/mcp/mcp_client.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/lib/mcp/mcp_client_registration_store.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/lib/memory/types.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/lib/tracing.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/lib/worktree.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/memory/__init__.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/setup_wizard.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/skills.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/templates/env.example +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/__init__.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/ask_user.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/bash/bash_command.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/bash/bash_output.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/bash/jobs.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/bash/kill_shell.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/create_agent_type.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/files/delete_file.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/files/edit_file.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/files/list_files.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/files/multi_edit.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/files/write_file.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/get_current_datetime.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/mcp/get_mcp_tool_details.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/mcp/search_mcp_tools.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/search/glob.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/search/grep.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/search/walk.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/send_message.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/settings.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/stop_agent.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/todo_write.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/web_fetch.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff/tools/web_search.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff.egg-info/dependency_links.txt +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff.egg-info/entry_points.txt +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/dostuff.egg-info/top_level.txt +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/setup.cfg +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_bash_command.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_checkpoints_todos_caching.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_create_agent_type.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_export_session.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_file_mentions.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_file_tools.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_jobs.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_mcp_e2e.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_mcp_env_references.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_mcp_oauth.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_opencode.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_pastes.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_permissions.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_session_store.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_settings_tools.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_setup_wizard.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_side_question.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_side_question_litellm.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_skill_command.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_skills_discovery.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_slash_suggestion.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_steering.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_subagent.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_terminal_signals.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_tool_schemas.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_web_fetch.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_web_search.py +0 -0
- {dostuff-0.2.13 → dostuff-0.2.15}/tests/test_worktree.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: dostuff
|
|
3
|
-
Version: 0.2.
|
|
3
|
+
Version: 0.2.15
|
|
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
|
|
@@ -37,8 +37,15 @@ Provides-Extra: memory
|
|
|
37
37
|
Requires-Dist: chromadb>=1.5.0; extra == "memory"
|
|
38
38
|
Provides-Extra: search
|
|
39
39
|
Requires-Dist: ddgs>=9.0; extra == "search"
|
|
40
|
+
Provides-Extra: images
|
|
41
|
+
Requires-Dist: Pillow>=10; extra == "images"
|
|
42
|
+
Provides-Extra: docs
|
|
43
|
+
Requires-Dist: pypdf>=4; extra == "docs"
|
|
44
|
+
Requires-Dist: python-docx>=1; extra == "docs"
|
|
45
|
+
Requires-Dist: openpyxl>=3.1; extra == "docs"
|
|
46
|
+
Requires-Dist: python-pptx>=0.6; extra == "docs"
|
|
40
47
|
Provides-Extra: full
|
|
41
|
-
Requires-Dist: dostuff[memory,search]; extra == "full"
|
|
48
|
+
Requires-Dist: dostuff[docs,images,memory,search]; extra == "full"
|
|
42
49
|
Requires-Dist: onnxruntime>=1.16; extra == "full"
|
|
43
50
|
Requires-Dist: grpcio>=1.52; extra == "full"
|
|
44
51
|
Provides-Extra: dev
|
|
@@ -78,11 +85,11 @@ DoStuff is a terminal AI agent that runs anywhere `pip` runs. It gives you a ful
|
|
|
78
85
|
- **Multi-provider LLMs** via [litellm](https://docs.litellm.ai/docs/providers) — OpenAI, Anthropic, Gemini, Groq, Mistral, Ollama, OpenRouter, OpenCode Zen / Go
|
|
79
86
|
- **Persistent sessions** in SQLite; resume with `dostuff -c`, `dostuff resume` or `dostuff --session <id>`, branch one off with `/fork`
|
|
80
87
|
- **Git worktrees** — `/worktree` or `dostuff -w` runs a session on its own branch and checkout; subagents can run in their own worktree too
|
|
81
|
-
- **Long-term memory** (semantic + episodic)
|
|
88
|
+
- **Long-term memory** (semantic + episodic) in a local SQLite file, searched by keywords and, with `pip install "dostuff[memory]"`, by meaning
|
|
82
89
|
- **MCP server support** — stdio (npx, uvx) and HTTP transports
|
|
83
90
|
- **`@file` mentions** — type `@` in the prompt to pick a file or folder; its content (or listing) is sent with the message
|
|
84
91
|
- **Project instructions** — `AGENTS.md` / `CLAUDE.md` from `~/.dostuff/`, the repo root and every folder down to the current one, combined
|
|
85
|
-
- **Coding tools** — `read_file` (line numbers, offset/limit), `edit_file` (exact replacement), `multi_edit` (several replacements in one file, all or nothing), `write_file`, `grep`, `glob`, `list_files`, `delete_file`, `bash_command`, `web_fetch` (read a URL as text), `web_search` (free, no API key)
|
|
92
|
+
- **Coding tools** — `read_file` (line numbers, offset/limit; it also opens images and PDFs for a model that can view them, and Word / Excel / PowerPoint files as text), `edit_file` (exact replacement), `multi_edit` (several replacements in one file, all or nothing), `write_file`, `grep`, `glob`, `list_files`, `delete_file`, `bash_command`, `web_fetch` (read a URL as text), `web_search` (free, no API key)
|
|
86
93
|
- **`ask_user`** — the agent asks you a real question — up to 4, with 2–4 options each, multi-select and a free-text "Other" — instead of guessing; the answers come back to it as one result and stay readable in `/resume`. See [Asking the user](#asking-the-user)
|
|
87
94
|
- **`/btw` side questions** — ask about the conversation while a turn runs (or idle) without stopping or queuing it: one model call, no tools run, answered in a panel above the input and never added to the history; `f` hands the question to a background agent that can check it with tools. See [Side questions](#side-questions-btw)
|
|
88
95
|
- **Mid-turn steering (`/steer`)** — send a correction to the turn that is running and the model reads it at the next tool boundary instead of waiting for the turn; plain messages steer by default, and `ui.mid_turn_messages: queue` batches them after the turn instead. See [Mid-turn steering](#mid-turn-steering-steer)
|
|
@@ -90,12 +97,12 @@ DoStuff is a terminal AI agent that runs anywhere `pip` runs. It gives you a ful
|
|
|
90
97
|
- **Hooks** — shell commands on `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `Stop`, `SubagentStart` and `SubagentStop` that can block a tool call or prompt, feed a formatter's output back to the model, or keep the turn going; Claude Code's hook I/O contract, and project hooks run only once you trust them. See [Hooks](#hooks)
|
|
91
98
|
- **Background jobs** — `bash_command(run_in_background=true)` starts dev servers, watchers and long test runs as jobs the agent reads with `bash_output` (`wait_for` a ready line) and stops with `kill_shell`; it hears when one ends. `Ctrl+B` moves a running command to the background, `/jobs` lists them, and none outlives the session. See [Background jobs](#background-jobs)
|
|
92
99
|
- **File sandbox** — file tools stay inside the project directory, plus read-only access to `.dostuff` (the project's and `~/.dostuff/`) and to discovered skill folders; `.env*` files, `mcp_config.json` and `.dostuff/data` (past sessions and prompts, saved MCP client secrets) are never readable
|
|
93
|
-
- **Skills loader** — drop a `SKILL.md` in the right folder, restart
|
|
100
|
+
- **Skills loader** — drop a `SKILL.md` in the right folder and the agent is told about it on your next message, no restart; run one with `/<skill-name> [args]`, name one mid-message to allow it for that message, or keep one manual-only with `disable-model-invocation`. See [Skills](#skills)
|
|
94
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)
|
|
95
102
|
- **Per-tool timeout** (120s) to prevent hung servers; long tool output is truncated (head + tail) before it reaches the model
|
|
96
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
|
|
97
104
|
- **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
|
|
98
|
-
- **Long-term memory tools** — the agent saves facts (`save_memory
|
|
105
|
+
- **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
|
|
99
106
|
- **Graceful exit** — `Ctrl+Q` or `/exit` saves the session, cleans up, and stops background workers
|
|
100
107
|
- **Clean Cancellation** — `Escape` can cancel in-flight agent turns cleanly without corrupting the session
|
|
101
108
|
- **2-state session split** — `session_steps` (full audit) / `working_history` (LLM payload); DB persists both plus `compaction_notes` + `last_input_tokens`
|
|
@@ -119,9 +126,11 @@ Optional features come as extras:
|
|
|
119
126
|
| Install | Adds |
|
|
120
127
|
|---|---|
|
|
121
128
|
| `pip install dostuff` | Everything except the extras below, including MCP (with OAuth tokens kept in the OS keyring) |
|
|
122
|
-
| `pip install "dostuff[memory]"` |
|
|
129
|
+
| `pip install "dostuff[memory]"` | Memory recall by meaning as well as by keywords (a reworded question still finds the memory), and semantic MCP tool search, via ChromaDB. Large download. Memory itself works without it |
|
|
123
130
|
| `pip install "dostuff[search]"` | Steadier `web_search` through the `ddgs` package (several engines) instead of DuckDuckGo's HTML page |
|
|
124
|
-
| `pip install "dostuff[
|
|
131
|
+
| `pip install "dostuff[docs]"` | Word, Excel and PowerPoint files (`.docx`, `.xlsx`, `.pptx`), and PDFs for models that can't read them, converted to text for `@path` and `read_file` (`pypdf`, `python-docx`, `openpyxl`, `python-pptx`) |
|
|
132
|
+
| `pip install "dostuff[images]"` | Pillow: large images are downscaled to fit the model's limit, and `Alt+V` reads the clipboard directly |
|
|
133
|
+
| `pip install "dostuff[full]"` | `memory` + `search` + `docs` + `images` |
|
|
125
134
|
| `pip install "dostuff[dev]"` | `pytest` and `mypy`, for working on dostuff itself |
|
|
126
135
|
|
|
127
136
|
Extras combine, e.g. `pip install "dostuff[memory,search]"`. Without `memory` everything else
|
|
@@ -143,7 +152,7 @@ For development (editable mode, from a clone):
|
|
|
143
152
|
git clone https://github.com/kVarunkk/DoStuff.git
|
|
144
153
|
cd DoStuff
|
|
145
154
|
pip install -e . # core
|
|
146
|
-
pip install -e ".[memory]" # +
|
|
155
|
+
pip install -e ".[memory]" # + memory search by meaning (chromadb)
|
|
147
156
|
pip install -e ".[search]" # + ddgs web search
|
|
148
157
|
pip install -e ".[full]" # + memory + search
|
|
149
158
|
pip install -e ".[dev]" # + pytest + mypy
|
|
@@ -202,6 +211,7 @@ In the TUI:
|
|
|
202
211
|
| `dostuff setup` | Pick a model, save its API key, write `~/.dostuff/config.yaml` (runs automatically on first launch) |
|
|
203
212
|
| `dostuff config` | Show resolved config paths and values |
|
|
204
213
|
| `dostuff doctor` | Health check: config, API key, MCP, data dir; prints a fix for each problem |
|
|
214
|
+
| `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`) |
|
|
205
215
|
| `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 |
|
|
206
216
|
| `dostuff sessions [--all] [-n N]` | List sessions in the current directory with their title or first prompt (`--all`: every directory) |
|
|
207
217
|
| `dostuff sessions rename <id> <title>` | Name a session |
|
|
@@ -226,9 +236,10 @@ In the TUI:
|
|
|
226
236
|
| `!<command>` | Run a shell command directly (no approval); the command and its output are shown to the model on the next turn |
|
|
227
237
|
| `# <note>` | Add `- <note>` to `AGENTS.md`: you pick this project's or the global one (`~/.dostuff/AGENTS.md`); the agent follows it from the next message |
|
|
228
238
|
| `Shift+Enter` | Insert a newline (multi-line input). If your terminal sends it as plain Enter, use `\` then `Enter`, `Ctrl+Enter`, `Alt+Enter` or `Ctrl+J` |
|
|
229
|
-
| `@path` | Attach a file (numbered lines) or a folder listing to the message. Typing `@` lists matching project paths: `Tab` / `Enter` completes, a folder opens for the next part. `@"a b.txt"` for spaces. Also works with `dostuff -p`. `.env` files and binaries are never attached |
|
|
239
|
+
| `@path` | Attach a file (numbered lines) or a folder listing to the message. Typing `@` lists matching project paths: `Tab` / `Enter` completes, a folder opens for the next part. `@"a b.txt"` for spaces. Also works with `dostuff -p`. `.env` files and binaries are never attached. An image (PNG, JPEG, GIF or WebP, told apart by its content, not its extension) is sent to the model as an image when the model can read images, and shows as `[Image #1 · shot.png · 1280×720]`; on a model that can't, or over 3.75 MB, or more than 20 in one message, nothing is sent and your prompt goes back in the input (`-p` exits with code 1). With `dostuff[images]`, an image wider or taller than 1568 px, or over 3.75 MB, is downscaled first (a GIF only when it is over 3.75 MB). A PDF goes to the model as a document when the model reads PDFs (up to 32 MB and 100 pages), shown as `[PDF · report.pdf · 12 pages]`; otherwise its text is attached. Word, Excel and PowerPoint files (`.docx`, `.xlsx`, `.pptx`) are attached as text: headings and tables as markdown, one table per sheet (values, not formulas), one section per slide with its notes. A converted file over 200 lines (`loop.paste_file_lines`) is saved to `.dostuff/attachments/` and the model reads it from there. Converting needs `dostuff[docs]`; without it, or for the old `.doc` / `.xls` / `.ppt` formats, the prompt goes back with the reason. Images and PDFs are copied to `.dostuff/attachments/` and removed after `loop.attachment_retention_days` (30). For a model dostuff can't tell about, set `vision: true` / `pdf_input: true` (or `false`) on its `models:` entry |
|
|
230
240
|
| `Tab` | While typing a slash command, accept the dim ghost text after the cursor: the rest of the command name, then its flag (`/model ` → `--active`, `/fork ` → `--worktree`). `Right` accepts it too |
|
|
231
|
-
| Paste | A paste over 10 lines (`ui.paste_collapse_lines`) or 2,000 chars shows as `[Pasted text #1 +243 lines]` and is expanded when you send it. Over 200 lines (`loop.paste_file_lines`) it's saved to `.dostuff/pastes/` and the model reads it from there, so it doesn't fill the context; files are removed after `loop.paste_retention_days` (7) |
|
|
241
|
+
| Paste | A paste over 10 lines (`ui.paste_collapse_lines`) or 2,000 chars shows as `[Pasted text #1 +243 lines]` and is expanded when you send it. Over 200 lines (`loop.paste_file_lines`) it's saved to `.dostuff/pastes/` and the model reads it from there, so it doesn't fill the context; files are removed after `loop.paste_retention_days` (7). Dragging an image or document into the terminal pastes its path; dostuff turns it into an `@path` mention, or, for an image outside the project, attaches it like `Alt+V` |
|
|
242
|
+
| `Alt+V` | Paste an image from the clipboard (a screenshot, an image copied in a browser). It shows as `[Image #1]` in the input, and is sent with your message under the same rules as an `@image` mention (a model that can read images, 3.75 MB, 20 per message). `Ctrl+V` stays the terminal's own paste, which carries only text. Uses Pillow when installed (`dostuff[images]`), otherwise PowerShell on Windows, `osascript` on macOS, and `wl-paste` or `xclip` on Linux. Checked on Windows; macOS and Linux are untested so far |
|
|
232
243
|
| `Up` / `Down` | On the first / last line of the input: previous / next prompt typed in this directory (saved in `~/.dostuff/data/prompt_history.jsonl`) |
|
|
233
244
|
| `Ctrl+R` | Search the prompts typed in this directory (type to filter, `Enter` puts the prompt in the input) |
|
|
234
245
|
| `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 |
|
|
@@ -236,7 +247,8 @@ In the TUI:
|
|
|
236
247
|
| `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) |
|
|
237
248
|
| `Shift+Tab` | Cycle the permission mode for this session: ask → auto → plan → allowlist (shown in the status bar) |
|
|
238
249
|
| `Ctrl+Backspace` / `Ctrl+W` / `Alt+Backspace` | Delete the previous word; `Ctrl+Delete` / `Alt+Delete` the next one |
|
|
239
|
-
| `/agents` / `/agents types` / `/agents reload` | This session's agents (running first): pick one to read its transcript, answer its approval prompt or stop it / the agent types with their source, model and tools (`/agents types <name>`: one type's system prompt and config) / re-read the agent files |
|
|
250
|
+
| `/agents` / `/agents types` / `/agents reload` | This session's agents (running first): pick one to read its transcript, answer its approval prompt or stop it / the agent types with their source, model and tools (`/agents types <name>`: one type's system prompt and config) / re-read the agent files and rebuild the system prompt from them |
|
|
251
|
+
| `/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) |
|
|
240
252
|
| `/exit` | Save the session and quit |
|
|
241
253
|
| `/clear` | Start a new session; the old one stays resumable |
|
|
242
254
|
| `/resume [<id>]` | Pick another session from this directory (or switch to the given one) |
|
|
@@ -250,7 +262,7 @@ In the TUI:
|
|
|
250
262
|
| `/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 |
|
|
251
263
|
| `/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 |
|
|
252
264
|
| `/status` | Session, directory, model, permission mode, tokens, context use, MCP servers |
|
|
253
|
-
| `/context` | What fills the context window: system prompt, turn context (the environment
|
|
265
|
+
| `/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 |
|
|
254
266
|
| `/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 |
|
|
255
267
|
| `/doctor` | The `dostuff doctor` checks (config, API key, MCP config, memory, hooks), with a fix for each problem |
|
|
256
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`) |
|
|
@@ -264,9 +276,9 @@ In the TUI:
|
|
|
264
276
|
| `/export [<path>]` | Save this session as Markdown (default `dostuff-session-<id>.md`) |
|
|
265
277
|
| `/undo [force]` | Revert the agent's file changes from its last file-editing turn |
|
|
266
278
|
| `/compact` | Manually trigger context compaction; `/compact auto <1-100\|off>` sets the auto-compaction threshold for this session |
|
|
267
|
-
| `/memories` | List
|
|
279
|
+
| `/memories` | List your saved facts and this project's, newest first, with the date each was saved; `/memories consolidate` merges overlapping facts after showing you the change (not in auto mode) |
|
|
268
280
|
| `/episodes` | List saved episodes (decisions, corrections, fixes) recalled here, newest first |
|
|
269
|
-
| `/forget <key or id>` | Delete a saved fact (by key) or episode (by the id shown in `/episodes`) |
|
|
281
|
+
| `/forget <key or id>` | Delete a saved fact (by key: this project's first, `user:<key>` for the user-wide one) or episode (by the id shown in `/episodes`) |
|
|
270
282
|
| `Ctrl+Q` | Graceful quit with save |
|
|
271
283
|
| `Escape` | Cancel in-flight turn (also answers "no" to an open approval prompt) |
|
|
272
284
|
| `/help` | Show available in-TUI commands |
|
|
@@ -304,6 +316,7 @@ In the TUI:
|
|
|
304
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` |
|
|
305
317
|
| `agent`, `send_message`, `stop_agent` | — | no; each subagent's own calls ask, titled with the agent |
|
|
306
318
|
| `ask_user` | read | never (it is the agent talking to you; subagents never get it) |
|
|
319
|
+
| `save_memory`, `save_episode`, `search_memory` | read | never (each save is shown in the TUI; only with the `memory` extra; subagents never get them) |
|
|
307
320
|
| `read_settings` | read | never (MCP `env` / header values are shown as `<redacted>`) |
|
|
308
321
|
| `edit_config`, `set_mcp_server`, `remove_mcp_server`, `create_agent_type` | settings | **yes, in every mode but `auto`, with no "always" option** (shows the diff or the server's command) |
|
|
309
322
|
|
|
@@ -439,9 +452,24 @@ The top line is the tab strip: `▌` marks the question you are on (bold and ora
|
|
|
439
452
|
answered, and both sit in the same slot so the tabs never shift as you answer. The submit row is dim until
|
|
440
453
|
every question has an answer, then it brightens and the parenthetical hint goes away.
|
|
441
454
|
|
|
442
|
-
- **Nothing submits on one key.** A pick records the answer and moves to the next question; `Submit answers`
|
|
443
|
-
|
|
444
|
-
|
|
455
|
+
- **Nothing submits on one key.** A pick records the answer and moves to the next question; `Submit answers`
|
|
456
|
+
stays inert (`answer every question first`) until every question has one. `←`/`Shift+Tab` goes back, so an
|
|
457
|
+
earlier answer can be changed before submitting.
|
|
458
|
+
- **You review before it sends.** `Submit answers` opens a review of every question with your answer under it;
|
|
459
|
+
the review's own `Submit answers` row is what sends. From the review, `←`/`Shift+Tab` goes back to the
|
|
460
|
+
questions, and Enter on an answer (or its number, or a click) reopens that question to change it:
|
|
461
|
+
|
|
462
|
+
```
|
|
463
|
+
✓ DB · ✓ Auth · ▌ Review
|
|
464
|
+
Review your answers
|
|
465
|
+
1. Which database should I use?
|
|
466
|
+
→ Postgres
|
|
467
|
+
2. Which auth methods?
|
|
468
|
+
→ JWT, OAuth
|
|
469
|
+
────────────────────────────────────────────────────────
|
|
470
|
+
❯ Submit answers
|
|
471
|
+
↑/↓ select · Enter on an answer changes it · Enter on Submit sends · ← back · Esc cancel
|
|
472
|
+
```
|
|
445
473
|
- **`2-4` options, one line each**, with the trade-off where it matters. A multi-select question toggles with
|
|
446
474
|
`space` or its number, and the joined answer comes back in option order.
|
|
447
475
|
- **`Other`** is always the last row, numbered after the options: pick it and the input takes a typed answer (a
|
|
@@ -625,9 +653,13 @@ and can stop one with `stop_agent`.
|
|
|
625
653
|
| `send_message(to, message, run_in_background)` | Continue an agent. One that has ended runs again with its whole history plus the message; one still running reads it before its next step |
|
|
626
654
|
| `stop_agent(agent_id)` | Stop a running agent; its shell jobs are killed and its worktree is closed out |
|
|
627
655
|
|
|
628
|
-
A subagent can never start, message or stop agents, delete files, save memories, write the todo list or change
|
|
656
|
+
A subagent can never start, message or stop agents, delete files, save or search memories, write the todo list or change
|
|
629
657
|
settings, whatever its type asks for. At most `agents.max_concurrent` (4) run at once; more are queued.
|
|
630
658
|
|
|
659
|
+
A typed subagent sees your saved facts (user facts and this project's, read-only) before its first step, the same
|
|
660
|
+
list the main agent gets; `explore`, `plan` and any type with `omit_memory: true` don't. It never gets past episodes.
|
|
661
|
+
A fork already has them in the conversation it inherits.
|
|
662
|
+
|
|
631
663
|
### Agent types
|
|
632
664
|
|
|
633
665
|
| Type | Tools | For |
|
|
@@ -640,12 +672,14 @@ settings, whatever its type asks for. At most `agents.max_concurrent` (4) run at
|
|
|
640
672
|
Your own types are Markdown files with YAML frontmatter. They are searched in this order, and the first file with a
|
|
641
673
|
given `name` wins: `.dostuff/agents/` and `.claude/agents/` in the project, then `~/.dostuff/agents/` and
|
|
642
674
|
`~/.claude/agents/`. `agents.read_claude_agents: false` skips both `.claude` folders. A file can replace a built-in
|
|
643
|
-
type, except `fork`. Files are re-read when they change
|
|
675
|
+
type, except `fork`. Files are re-read when they change, and a type added or removed mid-session is announced to the
|
|
676
|
+
agent before its next model call (see [Adding skills mid-session](#adding-skills-and-agent-types-mid-session));
|
|
677
|
+
`/agents reload` re-reads them now and rebuilds the system prompt.
|
|
644
678
|
|
|
645
679
|
You can also ask the agent for one ("make a code-reviewer agent"): its `create_agent_type(name, description, prompt,
|
|
646
680
|
tools, model, max_iterations, scope, replace)` tool writes the file to `.dostuff/agents/` (`scope="user"`:
|
|
647
681
|
`~/.dostuff/agents/`) after showing it to you. Like the settings tools, it asks in every mode. The new type can be
|
|
648
|
-
started at once.
|
|
682
|
+
started at once, and the agent is told about it before its next step.
|
|
649
683
|
|
|
650
684
|
```markdown
|
|
651
685
|
---
|
|
@@ -654,6 +688,7 @@ description: Reviews a diff for bugs and missing tests. Use after a change.
|
|
|
654
688
|
tools: Read, Grep, Glob, Bash # omit for every subagent tool
|
|
655
689
|
model: fast # inherit (default), an alias from agents.models, or a litellm model string
|
|
656
690
|
max_iterations: 30 # optional; default agents.max_iterations
|
|
691
|
+
omit_memory: true # optional; leave out your saved facts (default false)
|
|
657
692
|
---
|
|
658
693
|
You are a code reviewer. Report findings as a list, most severe first.
|
|
659
694
|
```
|
|
@@ -674,7 +709,8 @@ Unknown and forbidden names are dropped with a warning naming the file; `/agents
|
|
|
674
709
|
source, resolved model, tools and any warnings, and `/agents types <name>` shows one type's whole config: its
|
|
675
710
|
system prompt, model, tools and max iterations (for `fork`, the task message it gets). `model:` aliases come from `agents.models`; Claude Code's `sonnet`,
|
|
676
711
|
`opus` and `haiku` are looked up there too and fall back to the main model (with a warning in the report) when they
|
|
677
|
-
aren't defined. The call's `model=` wins over the type's `model:`.
|
|
712
|
+
aren't defined. The call's `model=` wins over the type's `model:`. Claude Code's `memory:` field (a per-agent memory
|
|
713
|
+
folder) is ignored with a warning: DoStuff has no per-agent memory.
|
|
678
714
|
|
|
679
715
|
### Background agents
|
|
680
716
|
|
|
@@ -846,7 +882,7 @@ worktree), with no terminal. stdin is one JSON object:
|
|
|
846
882
|
| Event | Extra keys |
|
|
847
883
|
|---|---|
|
|
848
884
|
| `PreToolUse`, `PostToolUse` | `tool_name`, `tool_input`, `tool_use_id`; `PostToolUse` also `tool_response` (the result, already truncated) |
|
|
849
|
-
| `UserPromptSubmit` | `prompt` |
|
|
885
|
+
| `UserPromptSubmit` | `prompt` (the text you typed; images and documents appear as `[Image: name]` / `[PDF: name]`), `attachments` (`[{"name", "kind", "path"}]`, empty when there are none) |
|
|
850
886
|
| `SessionStart` | `source` |
|
|
851
887
|
| `Stop`, `SubagentStop` | `last_assistant_message`, `stop_hook_active` (true once a Stop hook already continued this turn) |
|
|
852
888
|
| `SubagentStart` | `agent_id`, `agent_type`, `background`, `prompt` |
|
|
@@ -956,6 +992,7 @@ loop:
|
|
|
956
992
|
retry_max_delay: 60 # cap on each wait, seconds; Retry-After is honored
|
|
957
993
|
|
|
958
994
|
memory:
|
|
995
|
+
backend: hybrid # hybrid (default) | sqlite (keywords only) | chroma (the store before hybrid)
|
|
959
996
|
episodic_scope: project # recall past episodes from this directory (project) or anywhere (user)
|
|
960
997
|
|
|
961
998
|
permissions:
|
|
@@ -1149,7 +1186,7 @@ Detailed instructions for the agent go here.
|
|
|
1149
1186
|
|
|
1150
1187
|
**Running a skill yourself:** each skill is also a slash command, `/<name> [arguments]` (e.g. `/my-skill src/app.py`), in the TUI and with `dostuff -p "/my-skill ..."`. The turn's message is the skill's `SKILL.md` body plus your arguments (which can use `@path` mentions), so the model follows it straight away instead of deciding whether to read it. The command shows in the `/` menu marked `(skill)` and in `/help`. Built-in commands win a name clash, the first skill found (in the order above) wins between skills, and names with spaces can't be run this way; the model can still use those skills on its own.
|
|
1151
1188
|
|
|
1152
|
-
**Manual-only skills:** add `disable-model-invocation: true` to the frontmatter and the model is not told about the skill. It is left out of the system prompt and every subagent's prompt, so it only runs when you ask for it, with `/<name>` or a mention (below). It stays in the `/` menu and `/help`,
|
|
1189
|
+
**Manual-only skills:** add `disable-model-invocation: true` to the frontmatter and the model is not told about the skill. It is left out of the system prompt and every subagent's prompt, so it only runs when you ask for it, with `/<name>` or a mention (below). It stays in the `/` menu and `/help`, where it is marked `manual only`, as it is in the `Skills loaded` line at startup and in `/skills`. Only `false`, `no`, `off`, `0` or an empty value leave a skill visible to the model; anything else, a typo included, hides it.
|
|
1153
1190
|
|
|
1154
1191
|
> [!IMPORTANT]
|
|
1155
1192
|
> `disable-model-invocation` is **not a security boundary**. It stops the model from discovering and choosing the
|
|
@@ -1163,7 +1200,25 @@ A mention follows a space or a new line, can be any case, and may end in one `.`
|
|
|
1163
1200
|
|
|
1164
1201
|
While you type, `/` after a space opens the menu with skills only. Tab and Enter there replace just that word: your sentence stays and nothing is sent until the next Enter.
|
|
1165
1202
|
|
|
1166
|
-
Run `dostuff init` to bootstrap a local `.dostuff/skills/` folder.
|
|
1203
|
+
Run `dostuff init` to bootstrap a local `.dostuff/skills/` folder.
|
|
1204
|
+
|
|
1205
|
+
### Adding skills and agent types mid-session
|
|
1206
|
+
|
|
1207
|
+
No restart is needed. Before every model call dostuff checks the skill folders (a quick look at file sizes and
|
|
1208
|
+
times, a few milliseconds; a skill is re-read only when something moved) and the agent folders. When a skill or agent
|
|
1209
|
+
type was added, removed, or had its `description` changed since the agent was last told, it gets a short hidden note
|
|
1210
|
+
with the name, description and, for a skill, its folder. That includes one the agent made itself mid-turn, e.g. with
|
|
1211
|
+
`create_agent_type`: the note arrives before its next step. You don't see the note in the transcript, but `/name`
|
|
1212
|
+
works for a new skill from your next message, the `/` menu and `/help` list it, and the file tools can read its
|
|
1213
|
+
folder. A removed skill stops being a command and stops being readable at the same moment. Manual-only skills are
|
|
1214
|
+
never announced. Subagents get the same notes for skills that appear while they run.
|
|
1215
|
+
|
|
1216
|
+
The system prompt itself keeps the lists it was built with, so the provider's prompt cache stays warm; the note is
|
|
1217
|
+
added after your message, and a note at the start of a turn joins your message. It is rebuilt when you enter or
|
|
1218
|
+
leave a worktree, save `AGENTS.md` (`/memory`, `# note`), or run `/skills reload` or `/agents reload`. Those two re-read everything now and
|
|
1219
|
+
rebuild the prompt from the next message (the next request then pays one uncached prompt). Use them after
|
|
1220
|
+
editing a skill's `description` on a drive with coarse file times, or whenever you want the prompt itself current.
|
|
1221
|
+
Editing a `SKILL.md` body needs nothing: the agent reads the body when it uses the skill.
|
|
1167
1222
|
|
|
1168
1223
|
### Custom commands
|
|
1169
1224
|
|
|
@@ -1190,12 +1245,20 @@ after adding a command.
|
|
|
1190
1245
|
- **DB:** `~/.dostuff/data/sessions.db` (SQLite)
|
|
1191
1246
|
- **Resume:** `dostuff resume` (latest in the current dir), `dostuff resume <id>` or `dostuff --session <id>`
|
|
1192
1247
|
- **List:** `dostuff sessions` (current dir) / `dostuff sessions --all`
|
|
1193
|
-
- **Memory
|
|
1248
|
+
- **Memory store:** `~/.dostuff/data/memory.db` (SQLite), built in; no extra needed. It needs SQLite's FTS5 (full-text search), which almost every Python's `sqlite3` includes; on one without it, memory uses the `chroma` store when the `memory` extra is installed and is off otherwise, and the TUI, `dostuff -p` and `dostuff doctor` say so
|
|
1194
1249
|
- Semantic (key/value facts)
|
|
1195
1250
|
- Episodic (events with summaries and timestamps)
|
|
1196
|
-
- **
|
|
1251
|
+
- **Backends** (`memory.backend`) — `hybrid` (the default) searches `memory.db` two ways at once: by keywords (SQLite full-text search), and, with `pip install "dostuff[memory]"`, by meaning through an embedding index in `~/.dostuff/data/memory-index/`, so a question worded differently from the memory still finds it. Without the extra it searches by keywords only. `sqlite` is keywords only; `chroma` is the embeddings-only store dostuff used before. On a retrieval benchmark (LongMemEval-S, 470 questions), hybrid put the right memory in its top 5 for 97% of questions (keywords alone 96%, embeddings alone 74%) and delivered it to the agent automatically for 85% (59% and 65%).
|
|
1252
|
+
- **Upgrading from the chroma store** — on the first start with `hybrid` or `sqlite`, the facts and episodes in `~/.dostuff/data/chroma/` are copied into `memory.db` once (the TUI says how many; `dostuff -p` says it on stderr); `~/.dostuff/data/chroma/` itself is left as it was, so `memory.backend: chroma` still finds them. A memory you forget afterwards is not brought back. If the extra isn't installed, nothing is copied and the TUI says how to bring them in. The embedding index then fills in the background ("Indexing N memories..."); until it has, those memories are found by keywords.
|
|
1253
|
+
- **Saved when:** the agent decides — `save_memory` stores a key/value fact (an overlapping fact of the same scope is updated, not duplicated) and `save_episode` stores a decision, correction or lesson (one that rewords an episode already saved in the directory is skipped; for one of the same type that is close but not a near-copy, the model is asked whether it adds anything to the saved one, and it is skipped only when the answer is clearly that it adds nothing (an unclear answer or a failed call saves it); a lesson next to the event it explains is always kept). Each save is shown in the TUI; nothing is extracted at exit. Subagents can't save memories.
|
|
1254
|
+
- **Fact scopes** — a fact is about you (`scope="user"`, the default: your name, editor, how you like answers) or about one project (`scope="project"`: its tooling, conventions, decisions), keyed by the directory it was saved in. The same key can be saved once per scope and project. A project fact is only shown in its own directory.
|
|
1197
1255
|
- **Two step tables** — `session_steps` (full audit, shown on resume) and `working_steps` (what the model sees; compaction flags old rows instead of rewriting them). Each step is one INSERT. DBs from 0.1.6 and earlier are migrated on first open (`PRAGMA user_version`).
|
|
1198
|
-
- **
|
|
1256
|
+
- **Fact delivery** — every saved fact (yours plus this project's) is listed for the agent before its first model call, in a hidden step after your prompt, and sent again only when the list changes (a save, an update, `/forget`) or a compaction drops it, so the prompt cache holds. Facts are listed newest first until they fill a budget of about 4,000 tokens (a few hundred typical facts), with project facts taking at most 60% of it; past that, up to 3 of the rest that match the prompt are added to that turn's context (a fact already added earlier in the session isn't added again until a compaction drops it, unless its value changed), and the agent can look up the others with `search_memory`. Typed subagents get the same list (see [Subagents](#subagents)). While some facts are left out, every turn's context says how many, with a reminder to search before writing code or committing.
|
|
1257
|
+
- **Episode recall** — episodic memories come from your past sessions in the same directory (`memory.episodic_scope: user` for all directories); only episodes related to the prompt are recalled (an unrelated prompt like "hi" gets none), up to 3 a turn, and one the session already shows isn't recalled again until a compaction drops it. The block says how many matched and (in project scope) how many the project has saved, so the agent knows when more exist. Older episodes rank lower by type: an event loses half its weight in about two weeks, a lesson in about ten, and a decision, preference or correction doesn't fade. A project keeps at most 200 episodes; past that, the lowest-ranked go after each save, never a decision. The agent is told never to save facts that only appeared in tool output. List them with `/memories` and `/episodes`, delete one with `/forget`.
|
|
1258
|
+
- **Episode index** — besides the episodes recalled for a prompt, the agent gets a list of the episodes saved in this project, one line each (`[DECISION 2026-10-30] Chose SQLite for the cache`), in a hidden step like the facts: decisions, preferences and corrections first, newest first, then lessons and events by how recent they are, up to about 1,500 tokens (the list says when older ones are left out). It is sent again only when an episode is saved, forgotten or pruned, so the prompt cache holds. It lets the agent see that a decision exists even when the prompt shares no words with it, and look up the detail with `search_memory`. Subagents don't get it.
|
|
1259
|
+
- **Searching memory** — `search_memory` lets the agent look past those limits itself: facts that aren't in its list (yours and this project's) and this project's episodes (every directory's with `episodic_scope: user`), ranked by how well they match its query alone, with no fade for age; each result shows its date and, for an episode, its type. A search returns up to 10 facts and 5 episodes (the agent can ask for up to 20 and 10), and says when more facts matched, so the agent can search again with narrower words. For a question about a kind of memory (what was decided, what you corrected, what was learned) the agent can name an episode type: every episode of that type is ranked first, even one that shares no words with the question, followed by the ordinary matches of other types, so a wrong type never hides what the search would otherwise find. When its list doesn't hold every saved fact, it is told to search before it writes code, commits, or changes the database, CI, dependencies or the build, and when an error looks familiar or you ask what was decided. It only reads, so it never asks and works in plan mode; subagents don't get it.
|
|
1260
|
+
- **Consolidating facts** — `/memories consolidate` (or `dostuff memory consolidate`) asks the model once to merge overlapping facts (yours and this project's, never across the two), shows what would be removed, changed and added, and writes it only when you say yes. It is never automatic; in auto mode it refuses rather than ask (on the command line, `--yes` merges without asking). The TUI suggests it at startup and in `/memories` once you have more than 30 user facts.
|
|
1261
|
+
- **Index repair** — on the default backend, `memory.db` is the record and both indexes are rebuilt from it: every save also queues the change for the embedding index in the same transaction, so a crash or an index error only delays it (the next save or search catches up), a search never returns a memory that `memory.db` no longer has, and the TUI indexes whatever is missing at startup. If the embedding index fails, recall carries on by keywords. `dostuff memory check` reports what is out of step and `dostuff memory repair` fixes it. On `memory.backend: chroma`, if Chroma's vector index gets out of sync with its stored rows (chroma-core/chroma#7032), recall and saving fall back to a slower scan instead of failing, and the TUI warns at startup. `dostuff memory repair` rebuilds the index; rows it can't rebuild are left out but kept in the backup, and a failed rebuild leaves the original as it was. `dostuff memory repair --reembed` also re-embeds facts saved by older versions (as `"User's <key> is <value>"`) as their value alone, after a backup; they keep working without it.
|
|
1199
1262
|
- **Token persistence** — `prompt_tokens` / `completion_tokens` / `total_tokens` / `last_input_tokens` saved to DB; resume restores percent from DB meta
|
|
1200
1263
|
|
|
1201
1264
|
Long-term memory survives `pip install . --upgrade` because it lives in the user's home directory, not in the package.
|
|
@@ -1304,7 +1367,7 @@ dostuff/
|
|
|
1304
1367
|
│ ├── files/ # read, write, edit, delete, list
|
|
1305
1368
|
│ ├── search/ # grep and glob (pure Python, default excludes)
|
|
1306
1369
|
│ ├── mcp/ # mcp tool search, detail, and execution wrappers
|
|
1307
|
-
│ ├── memory/ # save_memory / save_episode
|
|
1370
|
+
│ ├── memory/ # save_memory / save_episode / search_memory
|
|
1308
1371
|
│ ├── settings.py # read_settings, edit_config, set/remove_mcp_server
|
|
1309
1372
|
│ ├── web_fetch.py # read a URL as text
|
|
1310
1373
|
│ ├── web_search.py # free web search (SearXNG / ddgs / DuckDuckGo)
|