@draht/coding-agent 2026.7.30 → 2026.9.5-1
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.
- package/CHANGELOG.md +154 -0
- package/README.md +46 -2
- package/agents/debugger.md +12 -1
- package/agents/git-committer.md +1 -0
- package/agents/implementer.md +20 -0
- package/agents/investigator.md +75 -0
- package/agents/reviewer.md +7 -0
- package/agents/spec-reviewer.md +66 -0
- package/agents/verifier.md +4 -3
- package/bin/draht-tools.cjs +472 -41
- package/dist/agents/debugger.md +12 -1
- package/dist/agents/git-committer.md +1 -0
- package/dist/agents/implementer.md +20 -0
- package/dist/agents/investigator.md +75 -0
- package/dist/agents/reviewer.md +7 -0
- package/dist/agents/spec-reviewer.md +66 -0
- package/dist/agents/verifier.md +4 -3
- package/dist/cli/args.d.ts +10 -0
- package/dist/cli/args.d.ts.map +1 -1
- package/dist/cli/args.js +69 -2
- package/dist/cli/args.js.map +1 -1
- package/dist/cli/attach-mode.d.ts +61 -0
- package/dist/cli/attach-mode.d.ts.map +1 -1
- package/dist/cli/attach-mode.js +243 -5
- package/dist/cli/attach-mode.js.map +1 -1
- package/dist/cli/credential-print.d.ts +1 -1
- package/dist/cli/credential-print.d.ts.map +1 -1
- package/dist/cli/credential-print.js +5 -4
- package/dist/cli/credential-print.js.map +1 -1
- package/dist/config.d.ts +9 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +31 -4
- package/dist/config.js.map +1 -1
- package/dist/core/agent-session-runtime.d.ts +17 -1
- package/dist/core/agent-session-runtime.d.ts.map +1 -1
- package/dist/core/agent-session-runtime.js +87 -30
- package/dist/core/agent-session-runtime.js.map +1 -1
- package/dist/core/agent-session-services.d.ts +1 -1
- package/dist/core/agent-session-services.d.ts.map +1 -1
- package/dist/core/agent-session-services.js +1 -0
- package/dist/core/agent-session-services.js.map +1 -1
- package/dist/core/agent-session.d.ts +35 -16
- package/dist/core/agent-session.d.ts.map +1 -1
- package/dist/core/agent-session.js +149 -64
- package/dist/core/agent-session.js.map +1 -1
- package/dist/core/auth-storage.d.ts +5 -1
- package/dist/core/auth-storage.d.ts.map +1 -1
- package/dist/core/auth-storage.js +72 -15
- package/dist/core/auth-storage.js.map +1 -1
- package/dist/core/builtins/checkpoints.d.ts +20 -0
- package/dist/core/builtins/checkpoints.d.ts.map +1 -0
- package/dist/core/builtins/checkpoints.js +161 -0
- package/dist/core/builtins/checkpoints.js.map +1 -0
- package/dist/core/builtins/duet.d.ts +26 -0
- package/dist/core/builtins/duet.d.ts.map +1 -0
- package/dist/core/builtins/duet.js +660 -0
- package/dist/core/builtins/duet.js.map +1 -0
- package/dist/core/builtins/index.d.ts.map +1 -1
- package/dist/core/builtins/index.js +7 -1
- package/dist/core/builtins/index.js.map +1 -1
- package/dist/core/builtins/subagent.d.ts +24 -4
- package/dist/core/builtins/subagent.d.ts.map +1 -1
- package/dist/core/builtins/subagent.js +278 -35
- package/dist/core/builtins/subagent.js.map +1 -1
- package/dist/core/checkpoints/checkpoint-cli.d.ts +17 -0
- package/dist/core/checkpoints/checkpoint-cli.d.ts.map +1 -0
- package/dist/core/checkpoints/checkpoint-cli.js +78 -0
- package/dist/core/checkpoints/checkpoint-cli.js.map +1 -0
- package/dist/core/checkpoints/checkpoint-manager.d.ts +294 -0
- package/dist/core/checkpoints/checkpoint-manager.d.ts.map +1 -0
- package/dist/core/checkpoints/checkpoint-manager.js +865 -0
- package/dist/core/checkpoints/checkpoint-manager.js.map +1 -0
- package/dist/core/checkpoints/rewind.d.ts +141 -0
- package/dist/core/checkpoints/rewind.d.ts.map +1 -0
- package/dist/core/checkpoints/rewind.js +246 -0
- package/dist/core/checkpoints/rewind.js.map +1 -0
- package/dist/core/compaction/branch-summarization.d.ts +1 -1
- package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
- package/dist/core/compaction/branch-summarization.js +9 -4
- package/dist/core/compaction/branch-summarization.js.map +1 -1
- package/dist/core/compaction/compaction.d.ts +5 -0
- package/dist/core/compaction/compaction.d.ts.map +1 -1
- package/dist/core/compaction/compaction.js +25 -4
- package/dist/core/compaction/compaction.js.map +1 -1
- package/dist/core/extensions/index.d.ts +1 -1
- package/dist/core/extensions/index.d.ts.map +1 -1
- package/dist/core/extensions/index.js.map +1 -1
- package/dist/core/extensions/loader.d.ts.map +1 -1
- package/dist/core/extensions/loader.js +83 -20
- package/dist/core/extensions/loader.js.map +1 -1
- package/dist/core/extensions/runner.d.ts +13 -2
- package/dist/core/extensions/runner.d.ts.map +1 -1
- package/dist/core/extensions/runner.js +37 -2
- package/dist/core/extensions/runner.js.map +1 -1
- package/dist/core/extensions/types.d.ts +189 -6
- package/dist/core/extensions/types.d.ts.map +1 -1
- package/dist/core/extensions/types.js.map +1 -1
- package/dist/core/http-dispatcher.d.ts.map +1 -1
- package/dist/core/http-dispatcher.js +7 -0
- package/dist/core/http-dispatcher.js.map +1 -1
- package/dist/core/index.d.ts +1 -1
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/index.js.map +1 -1
- package/dist/core/keybindings.d.ts +5 -0
- package/dist/core/keybindings.d.ts.map +1 -1
- package/dist/core/keybindings.js +1 -0
- package/dist/core/keybindings.js.map +1 -1
- package/dist/core/model-registry.d.ts +3 -2
- package/dist/core/model-registry.d.ts.map +1 -1
- package/dist/core/model-registry.js +8 -8
- package/dist/core/model-registry.js.map +1 -1
- package/dist/core/model-resolver.d.ts.map +1 -1
- package/dist/core/model-resolver.js +34 -7
- package/dist/core/model-resolver.js.map +1 -1
- package/dist/core/model-runtime.d.ts +7 -1
- package/dist/core/model-runtime.d.ts.map +1 -1
- package/dist/core/model-runtime.js +30 -10
- package/dist/core/model-runtime.js.map +1 -1
- package/dist/core/multi-agent/permission-gate.d.ts.map +1 -1
- package/dist/core/multi-agent/permission-gate.js +4 -3
- package/dist/core/multi-agent/permission-gate.js.map +1 -1
- package/dist/core/multi-agent/worktree.d.ts +2 -0
- package/dist/core/multi-agent/worktree.d.ts.map +1 -1
- package/dist/core/multi-agent/worktree.js +2 -2
- package/dist/core/multi-agent/worktree.js.map +1 -1
- package/dist/core/package-manager.d.ts +7 -1
- package/dist/core/package-manager.d.ts.map +1 -1
- package/dist/core/package-manager.js +21 -44
- package/dist/core/package-manager.js.map +1 -1
- package/dist/core/permission-relay/index.d.ts +19 -0
- package/dist/core/permission-relay/index.d.ts.map +1 -0
- package/dist/core/permission-relay/index.js +49 -0
- package/dist/core/permission-relay/index.js.map +1 -0
- package/dist/core/permission-relay/relay-ui-context.d.ts +39 -0
- package/dist/core/permission-relay/relay-ui-context.d.ts.map +1 -0
- package/dist/core/permission-relay/relay-ui-context.js +788 -0
- package/dist/core/permission-relay/relay-ui-context.js.map +1 -0
- package/dist/core/permission-relay/types.d.ts +222 -0
- package/dist/core/permission-relay/types.d.ts.map +1 -0
- package/dist/core/permission-relay/types.js +15 -0
- package/dist/core/permission-relay/types.js.map +1 -0
- package/dist/core/pi-manifest.d.ts +14 -0
- package/dist/core/pi-manifest.d.ts.map +1 -0
- package/dist/core/pi-manifest.js +35 -0
- package/dist/core/pi-manifest.js.map +1 -0
- package/dist/core/project-trust.js +2 -2
- package/dist/core/project-trust.js.map +1 -1
- package/dist/core/resource-loader.d.ts +21 -0
- package/dist/core/resource-loader.d.ts.map +1 -1
- package/dist/core/resource-loader.js +101 -24
- package/dist/core/resource-loader.js.map +1 -1
- package/dist/core/sandbox/bash-operations.d.ts +149 -0
- package/dist/core/sandbox/bash-operations.d.ts.map +1 -0
- package/dist/core/sandbox/bash-operations.js +163 -0
- package/dist/core/sandbox/bash-operations.js.map +1 -0
- package/dist/core/sandbox/env.d.ts +83 -0
- package/dist/core/sandbox/env.d.ts.map +1 -0
- package/dist/core/sandbox/env.js +123 -0
- package/dist/core/sandbox/env.js.map +1 -0
- package/dist/core/sandbox/executor.d.ts +104 -0
- package/dist/core/sandbox/executor.d.ts.map +1 -0
- package/dist/core/sandbox/executor.js +92 -0
- package/dist/core/sandbox/executor.js.map +1 -0
- package/dist/core/sandbox/index.d.ts +36 -0
- package/dist/core/sandbox/index.d.ts.map +1 -0
- package/dist/core/sandbox/index.js +36 -0
- package/dist/core/sandbox/index.js.map +1 -0
- package/dist/core/sandbox/linux.d.ts +121 -0
- package/dist/core/sandbox/linux.d.ts.map +1 -0
- package/dist/core/sandbox/linux.js +260 -0
- package/dist/core/sandbox/linux.js.map +1 -0
- package/dist/core/sandbox/policy.d.ts +142 -0
- package/dist/core/sandbox/policy.d.ts.map +1 -0
- package/dist/core/sandbox/policy.js +297 -0
- package/dist/core/sandbox/policy.js.map +1 -0
- package/dist/core/sandbox/real-path.d.ts +112 -0
- package/dist/core/sandbox/real-path.d.ts.map +1 -0
- package/dist/core/sandbox/real-path.js +158 -0
- package/dist/core/sandbox/real-path.js.map +1 -0
- package/dist/core/sandbox/seatbelt-profile.d.ts +95 -0
- package/dist/core/sandbox/seatbelt-profile.d.ts.map +1 -0
- package/dist/core/sandbox/seatbelt-profile.js +239 -0
- package/dist/core/sandbox/seatbelt-profile.js.map +1 -0
- package/dist/core/sandbox/seatbelt.d.ts +95 -0
- package/dist/core/sandbox/seatbelt.d.ts.map +1 -0
- package/dist/core/sandbox/seatbelt.js +154 -0
- package/dist/core/sandbox/seatbelt.js.map +1 -0
- package/dist/core/sandbox/self-test.d.ts +109 -0
- package/dist/core/sandbox/self-test.d.ts.map +1 -0
- package/dist/core/sandbox/self-test.js +369 -0
- package/dist/core/sandbox/self-test.js.map +1 -0
- package/dist/core/sandbox/spawn.d.ts +33 -0
- package/dist/core/sandbox/spawn.d.ts.map +1 -0
- package/dist/core/sandbox/spawn.js +87 -0
- package/dist/core/sandbox/spawn.js.map +1 -0
- package/dist/core/sdk.d.ts.map +1 -1
- package/dist/core/sdk.js +3 -1
- package/dist/core/sdk.js.map +1 -1
- package/dist/core/session-manager.d.ts +60 -1
- package/dist/core/session-manager.d.ts.map +1 -1
- package/dist/core/session-manager.js +53 -6
- package/dist/core/session-manager.js.map +1 -1
- package/dist/core/settings-manager.d.ts +21 -0
- package/dist/core/settings-manager.d.ts.map +1 -1
- package/dist/core/settings-manager.js +36 -16
- package/dist/core/settings-manager.js.map +1 -1
- package/dist/core/skills.d.ts +3 -1
- package/dist/core/skills.d.ts.map +1 -1
- package/dist/core/skills.js +19 -6
- package/dist/core/skills.js.map +1 -1
- package/dist/core/slash-commands.d.ts.map +1 -1
- package/dist/core/slash-commands.js +1 -0
- package/dist/core/slash-commands.js.map +1 -1
- package/dist/core/soak/soak-log.d.ts +298 -0
- package/dist/core/soak/soak-log.d.ts.map +1 -0
- package/dist/core/soak/soak-log.js +660 -0
- package/dist/core/soak/soak-log.js.map +1 -0
- package/dist/core/soak/soak-reader.d.ts +60 -0
- package/dist/core/soak/soak-reader.d.ts.map +1 -0
- package/dist/core/soak/soak-reader.js +106 -0
- package/dist/core/soak/soak-reader.js.map +1 -0
- package/dist/core/socket-server/discovery.d.ts +78 -1
- package/dist/core/socket-server/discovery.d.ts.map +1 -1
- package/dist/core/socket-server/discovery.js +356 -37
- package/dist/core/socket-server/discovery.js.map +1 -1
- package/dist/core/socket-server/index.d.ts +10 -4
- package/dist/core/socket-server/index.d.ts.map +1 -1
- package/dist/core/socket-server/index.js +6 -3
- package/dist/core/socket-server/index.js.map +1 -1
- package/dist/core/socket-server/permission-delivery.d.ts +125 -0
- package/dist/core/socket-server/permission-delivery.d.ts.map +1 -0
- package/dist/core/socket-server/permission-delivery.js +152 -0
- package/dist/core/socket-server/permission-delivery.js.map +1 -0
- package/dist/core/socket-server/permission-registry.d.ts +301 -0
- package/dist/core/socket-server/permission-registry.d.ts.map +1 -0
- package/dist/core/socket-server/permission-registry.js +410 -0
- package/dist/core/socket-server/permission-registry.js.map +1 -0
- package/dist/core/socket-server/permission-relay.d.ts +81 -0
- package/dist/core/socket-server/permission-relay.d.ts.map +1 -0
- package/dist/core/socket-server/permission-relay.js +528 -0
- package/dist/core/socket-server/permission-relay.js.map +1 -0
- package/dist/core/socket-server/safe-text.d.ts +83 -0
- package/dist/core/socket-server/safe-text.d.ts.map +1 -0
- package/dist/core/socket-server/safe-text.js +277 -0
- package/dist/core/socket-server/safe-text.js.map +1 -0
- package/dist/core/socket-server/session-integration.d.ts +65 -2
- package/dist/core/socket-server/session-integration.d.ts.map +1 -1
- package/dist/core/socket-server/session-integration.js +434 -32
- package/dist/core/socket-server/session-integration.js.map +1 -1
- package/dist/core/socket-server/socket-client.d.ts +21 -2
- package/dist/core/socket-server/socket-client.d.ts.map +1 -1
- package/dist/core/socket-server/socket-client.js +52 -1
- package/dist/core/socket-server/socket-client.js.map +1 -1
- package/dist/core/socket-server/socket-server.d.ts +152 -1
- package/dist/core/socket-server/socket-server.d.ts.map +1 -1
- package/dist/core/socket-server/socket-server.js +775 -26
- package/dist/core/socket-server/socket-server.js.map +1 -1
- package/dist/core/socket-server/types.d.ts +106 -2
- package/dist/core/socket-server/types.d.ts.map +1 -1
- package/dist/core/socket-server/types.js +13 -1
- package/dist/core/socket-server/types.js.map +1 -1
- package/dist/core/system-prompt.d.ts.map +1 -1
- package/dist/core/system-prompt.js +8 -9
- package/dist/core/system-prompt.js.map +1 -1
- package/dist/core/tools/bash.d.ts +1 -1
- package/dist/core/tools/bash.d.ts.map +1 -1
- package/dist/core/tools/bash.js +5 -2
- package/dist/core/tools/bash.js.map +1 -1
- package/dist/core/tools/edit.d.ts.map +1 -1
- package/dist/core/tools/edit.js +17 -2
- package/dist/core/tools/edit.js.map +1 -1
- package/dist/core/tools/find.d.ts +3 -0
- package/dist/core/tools/find.d.ts.map +1 -1
- package/dist/core/tools/find.js +11 -18
- package/dist/core/tools/find.js.map +1 -1
- package/dist/core/trust-manager.d.ts +6 -4
- package/dist/core/trust-manager.d.ts.map +1 -1
- package/dist/core/trust-manager.js +55 -21
- package/dist/core/trust-manager.js.map +1 -1
- package/dist/extensions/index.d.ts.map +1 -1
- package/dist/extensions/index.js +5 -1
- package/dist/extensions/index.js.map +1 -1
- package/dist/extensions/llama/provider.d.ts.map +1 -1
- package/dist/extensions/llama/provider.js +5 -1
- package/dist/extensions/llama/provider.js.map +1 -1
- package/dist/extensions/stub-provider/index.d.ts +9 -0
- package/dist/extensions/stub-provider/index.d.ts.map +1 -0
- package/dist/extensions/stub-provider/index.js +13 -0
- package/dist/extensions/stub-provider/index.js.map +1 -0
- package/dist/extensions/stub-provider/provider.d.ts +77 -0
- package/dist/extensions/stub-provider/provider.d.ts.map +1 -0
- package/dist/extensions/stub-provider/provider.js +193 -0
- package/dist/extensions/stub-provider/provider.js.map +1 -0
- package/dist/hooks/gsd/draht-quality-gate.js +3 -3
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js.map +1 -1
- package/dist/main.d.ts.map +1 -1
- package/dist/main.js +242 -45
- package/dist/main.js.map +1 -1
- package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/config-selector.js +3 -2
- package/dist/modes/interactive/components/config-selector.js.map +1 -1
- package/dist/modes/interactive/components/extension-selector.d.ts +49 -0
- package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/extension-selector.js +202 -5
- package/dist/modes/interactive/components/extension-selector.js.map +1 -1
- package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/session-selector.js +10 -2
- package/dist/modes/interactive/components/session-selector.js.map +1 -1
- package/dist/modes/interactive/components/settings-selector.d.ts +2 -0
- package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/settings-selector.js +10 -0
- package/dist/modes/interactive/components/settings-selector.js.map +1 -1
- package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
- package/dist/modes/interactive/components/tool-execution.js +10 -1
- package/dist/modes/interactive/components/tool-execution.js.map +1 -1
- package/dist/modes/interactive/components/tree-selector.d.ts +20 -2
- package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
- package/dist/modes/interactive/components/tree-selector.js +21 -5
- package/dist/modes/interactive/components/tree-selector.js.map +1 -1
- package/dist/modes/interactive/interactive-mode.d.ts +97 -3
- package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
- package/dist/modes/interactive/interactive-mode.js +394 -24
- package/dist/modes/interactive/interactive-mode.js.map +1 -1
- package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-mode.js +165 -7
- package/dist/modes/rpc/rpc-mode.js.map +1 -1
- package/dist/modes/rpc/rpc-types.d.ts +68 -1
- package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-types.js.map +1 -1
- package/dist/prompts/commands/atomic-commit.md +1 -12
- package/dist/prompts/commands/brainstorm.md +12 -15
- package/dist/prompts/commands/create-verification-skill.md +108 -0
- package/dist/prompts/commands/discuss-phase.md +3 -14
- package/dist/prompts/commands/execute-phase.md +3 -11
- package/dist/prompts/commands/fix.md +41 -18
- package/dist/prompts/commands/grill.md +66 -0
- package/dist/prompts/commands/init-project.md +5 -15
- package/dist/prompts/commands/map-codebase.md +1 -13
- package/dist/prompts/commands/new-project.md +5 -15
- package/dist/prompts/commands/next-milestone.md +1 -13
- package/dist/prompts/commands/orchestrate.md +1 -1
- package/dist/prompts/commands/pause-work.md +1 -13
- package/dist/prompts/commands/plan-phase.md +2 -11
- package/dist/prompts/commands/progress.md +0 -13
- package/dist/prompts/commands/quick.md +3 -11
- package/dist/prompts/commands/resolve-conflicts.md +71 -0
- package/dist/prompts/commands/resume-work.md +0 -13
- package/dist/prompts/commands/review.md +4 -13
- package/dist/prompts/commands/triage.md +159 -0
- package/dist/prompts/commands/verify-work.md +4 -14
- package/dist/prompts/commands/why.md +135 -0
- package/dist/skills/atomic-reasoning/SKILL.md +115 -0
- package/dist/skills/blast-radius/SKILL.md +55 -0
- package/dist/skills/epistemics/SKILL.md +99 -0
- package/dist/skills/hexagon-animation/SKILL.md +49 -0
- package/dist/skills/hexagon-animation/generate.mjs +81 -0
- package/dist/skills/hexagon-animation/template.html +361 -0
- package/dist/skills/typescript-discipline/SKILL.md +50 -0
- package/dist/skills/typescript-discipline/references/patterns.md +294 -0
- package/dist/skills/unslop/SKILL.md +101 -0
- package/dist/utils/canonical-path.d.ts +28 -0
- package/dist/utils/canonical-path.d.ts.map +1 -0
- package/dist/utils/canonical-path.js +90 -0
- package/dist/utils/canonical-path.js.map +1 -0
- package/dist/utils/child-process.d.ts +12 -1
- package/dist/utils/child-process.d.ts.map +1 -1
- package/dist/utils/child-process.js +25 -8
- package/dist/utils/child-process.js.map +1 -1
- package/dist/utils/clipboard.d.ts +1 -1
- package/dist/utils/clipboard.d.ts.map +1 -1
- package/dist/utils/clipboard.js +22 -2
- package/dist/utils/clipboard.js.map +1 -1
- package/dist/utils/exif-orientation.d.ts.map +1 -1
- package/dist/utils/exif-orientation.js +2 -3
- package/dist/utils/exif-orientation.js.map +1 -1
- package/dist/utils/paths.d.ts +2 -7
- package/dist/utils/paths.d.ts.map +1 -1
- package/dist/utils/paths.js +13 -15
- package/dist/utils/paths.js.map +1 -1
- package/dist/utils/shell.d.ts.map +1 -1
- package/dist/utils/shell.js +6 -4
- package/dist/utils/shell.js.map +1 -1
- package/dist/utils/tools-manager.d.ts.map +1 -1
- package/dist/utils/tools-manager.js +3 -5
- package/dist/utils/tools-manager.js.map +1 -1
- package/docs/attachable-sessions.md +79 -0
- package/docs/compaction.md +21 -21
- package/docs/containerization.md +23 -23
- package/docs/custom-provider.md +16 -16
- package/docs/development.md +9 -9
- package/docs/docs.json +6 -2
- package/docs/duet.md +42 -0
- package/docs/extensions.md +58 -58
- package/docs/index.md +10 -10
- package/docs/json.md +7 -7
- package/docs/keybindings.md +6 -5
- package/docs/llama-cpp.md +6 -6
- package/docs/models.md +6 -6
- package/docs/packages.md +43 -43
- package/docs/prompt-templates.md +4 -4
- package/docs/providers.md +12 -12
- package/docs/quickstart.md +32 -32
- package/docs/rpc.md +83 -12
- package/docs/sdk.md +15 -15
- package/docs/security.md +18 -18
- package/docs/session-format.md +35 -13
- package/docs/sessions.md +17 -14
- package/docs/settings.md +25 -18
- package/docs/shell-aliases.md +2 -2
- package/docs/skills.md +12 -11
- package/docs/terminal-setup.md +12 -12
- package/docs/termux.md +6 -6
- package/docs/themes.md +11 -11
- package/docs/tmux.md +4 -4
- package/docs/tui.md +5 -5
- package/docs/usage.md +50 -50
- package/docs/windows.md +2 -2
- package/examples/extensions/overlay-qa-tests.ts +3 -3
- package/hooks/gsd/draht-quality-gate.js +3 -3
- package/package.json +11 -10
- package/prompts/commands/atomic-commit.md +1 -12
- package/prompts/commands/brainstorm.md +12 -15
- package/prompts/commands/create-verification-skill.md +108 -0
- package/prompts/commands/discuss-phase.md +3 -14
- package/prompts/commands/execute-phase.md +3 -11
- package/prompts/commands/fix.md +41 -18
- package/prompts/commands/grill.md +66 -0
- package/prompts/commands/init-project.md +5 -15
- package/prompts/commands/map-codebase.md +1 -13
- package/prompts/commands/new-project.md +5 -15
- package/prompts/commands/next-milestone.md +1 -13
- package/prompts/commands/orchestrate.md +1 -1
- package/prompts/commands/pause-work.md +1 -13
- package/prompts/commands/plan-phase.md +2 -11
- package/prompts/commands/progress.md +0 -13
- package/prompts/commands/quick.md +3 -11
- package/prompts/commands/resolve-conflicts.md +71 -0
- package/prompts/commands/resume-work.md +0 -13
- package/prompts/commands/review.md +4 -13
- package/prompts/commands/triage.md +159 -0
- package/prompts/commands/verify-work.md +4 -14
- package/prompts/commands/why.md +135 -0
- package/skills/atomic-reasoning/SKILL.md +115 -0
- package/skills/blast-radius/SKILL.md +55 -0
- package/skills/epistemics/SKILL.md +99 -0
- package/skills/hexagon-animation/SKILL.md +49 -0
- package/skills/hexagon-animation/generate.mjs +81 -0
- package/skills/hexagon-animation/template.html +361 -0
- package/skills/typescript-discipline/SKILL.md +50 -0
- package/skills/typescript-discipline/references/patterns.md +294 -0
- package/skills/unslop/SKILL.md +101 -0
- package/dist/prompts/agents/build.md +0 -86
- package/dist/prompts/agents/plan.md +0 -79
- package/dist/prompts/agents/verify.md +0 -69
- package/prompts/agents/build.md +0 -86
- package/prompts/agents/plan.md +0 -79
- package/prompts/agents/verify.md +0 -69
package/docs/llama-cpp.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# llama.cpp
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
draht supports the [llama.cpp](https://github.com/ggml-org/llama.cpp) router server. The router discovers multiple GGUF models and loads or unloads them on demand.
|
|
4
4
|
|
|
5
5
|
Use a current llama.cpp build with router support. Follow the [build instructions](https://github.com/ggml-org/llama.cpp/blob/master/docs/build.md) or install a [prebuilt release](https://github.com/ggml-org/llama.cpp/releases) for your platform.
|
|
6
6
|
|
|
@@ -43,9 +43,9 @@ A single-file model can sit directly in the model directory. Put multimodal and
|
|
|
43
43
|
|
|
44
44
|
Restart the router after manually adding files. For per-model context sizes and other options, use [llama.cpp model presets](https://github.com/ggml-org/llama.cpp/blob/master/tools/server/README.md#model-presets).
|
|
45
45
|
|
|
46
|
-
## Configure
|
|
46
|
+
## Configure draht
|
|
47
47
|
|
|
48
|
-
Start
|
|
48
|
+
Start draht and configure the provider:
|
|
49
49
|
|
|
50
50
|
```text
|
|
51
51
|
/login llama.cpp
|
|
@@ -76,11 +76,11 @@ Run:
|
|
|
76
76
|
- Select **Download model…**, search Hugging Face, then choose a repository and quantization. Exact `owner/repository[:quant]` values also work.
|
|
77
77
|
- Press Escape during a load or download to confirm cancellation.
|
|
78
78
|
|
|
79
|
-
Hugging Face search uses `HF_TOKEN` when set, then checks `$HF_TOKEN_PATH`, `$HF_HOME/token`, `$XDG_CACHE_HOME/huggingface/token`, and `~/.cache/huggingface/token`. Search also works without authentication, subject to lower rate limits.
|
|
79
|
+
Hugging Face search uses `HF_TOKEN` when set, then checks `$HF_TOKEN_PATH`, `$HF_HOME/token`, `$XDG_CACHE_HOME/huggingface/token`, and `~/.cache/huggingface/token`. Search also works without authentication, subject to lower rate limits. draht warns before downloading gated repositories and links to their access page. The llama.cpp server performs the download, so its process must also have `HF_TOKEN` when the selected repository requires access.
|
|
80
80
|
|
|
81
|
-
If other models are loaded,
|
|
81
|
+
If other models are loaded, draht asks whether to unload them first or keep them loaded. draht does not silently unload models and never deletes model files. The router may be shared with other clients, so `/llama` always displays the router's current state.
|
|
82
82
|
|
|
83
|
-
Only loaded models appear in `/model`. After loading a model, run `/model` to select it for the current
|
|
83
|
+
Only loaded models appear in `/model`. After loading a model, run `/model` to select it for the current draht session.
|
|
84
84
|
|
|
85
85
|
If the router disconnects, `/llama` shows **Retry** and **Close**. Retry reconnects and refreshes model state without replaying the interrupted operation.
|
|
86
86
|
|
package/docs/models.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Custom Models
|
|
2
2
|
|
|
3
|
-
Add custom providers and models (Ollama, vLLM, LM Studio, proxies) via `~/.
|
|
3
|
+
Add custom providers and models (Ollama, vLLM, LM Studio, proxies) via `~/.draht/agent/models.json`.
|
|
4
4
|
|
|
5
5
|
## Table of Contents
|
|
6
6
|
|
|
@@ -36,7 +36,7 @@ For local models (Ollama, LM Studio, vLLM), only `id` is required per model:
|
|
|
36
36
|
|
|
37
37
|
The `apiKey` is required but Ollama ignores it, so any value works.
|
|
38
38
|
|
|
39
|
-
Some OpenAI-compatible servers do not understand the `developer` role used for reasoning-capable models. For those providers, set `compat.supportsDeveloperRole` to `false` so
|
|
39
|
+
Some OpenAI-compatible servers do not understand the `developer` role used for reasoning-capable models. For those providers, set `compat.supportsDeveloperRole` to `false` so draht sends the system prompt as a `system` message instead. If the server also does not support `reasoning_effort`, set `compat.supportsReasoningEffort` to `false` too.
|
|
40
40
|
|
|
41
41
|
You can set `compat` at the provider level to apply to all models, or at the model level to override a specific model. This commonly applies to Ollama, vLLM, SGLang, and similar OpenAI-compatible servers.
|
|
42
42
|
|
|
@@ -168,7 +168,7 @@ The `apiKey` and `headers` fields support command execution, environment interpo
|
|
|
168
168
|
|
|
169
169
|
Legacy uppercase env-var-like values such as `MY_API_KEY` are migrated to `$MY_API_KEY` on startup.
|
|
170
170
|
|
|
171
|
-
For `models.json`, shell commands are resolved at request time.
|
|
171
|
+
For `models.json`, shell commands are resolved at request time. draht intentionally does not apply built-in TTL, stale reuse, or recovery logic for arbitrary commands. Different commands need different caching and failure strategies, and draht cannot infer the right one.
|
|
172
172
|
|
|
173
173
|
If your command is slow, expensive, rate-limited, or should keep using a previous value on transient failures, wrap it in your own script or command that implements the caching or TTL behavior you want.
|
|
174
174
|
|
|
@@ -201,7 +201,7 @@ If your command is slow, expensive, rate-limited, or should keep using a previou
|
|
|
201
201
|
| `name` | No | `id` | Human-readable model label. Used for matching (`--model` patterns) and shown as secondary model detail text. |
|
|
202
202
|
| `api` | No | provider's `api` | Override provider's API for this model |
|
|
203
203
|
| `reasoning` | No | `false` | Supports extended thinking |
|
|
204
|
-
| `thinkingLevelMap` | No | omitted | Maps
|
|
204
|
+
| `thinkingLevelMap` | No | omitted | Maps draht thinking levels to provider values and marks unsupported levels (see below) |
|
|
205
205
|
| `input` | No | `["text"]` | Input types: `["text"]` or `["text", "image"]` |
|
|
206
206
|
| `contextWindow` | No | `128000` | Context window size in tokens |
|
|
207
207
|
| `maxTokens` | No | `16384` | Maximum output tokens |
|
|
@@ -236,7 +236,7 @@ Current behavior:
|
|
|
236
236
|
|
|
237
237
|
### Thinking Level Map
|
|
238
238
|
|
|
239
|
-
Use `thinkingLevelMap` on a model to describe model-specific thinking controls. Keys are
|
|
239
|
+
Use `thinkingLevelMap` on a model to describe model-specific thinking controls. Keys are draht thinking levels: `off`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max`. Maps may contain holes; for example, a model can expose `high` and `max` without exposing `xhigh`.
|
|
240
240
|
|
|
241
241
|
Values are tristate:
|
|
242
242
|
|
|
@@ -372,7 +372,7 @@ Behavior notes:
|
|
|
372
372
|
|
|
373
373
|
For providers or proxies using `api: "anthropic-messages"`, use `compat` to control Anthropic-specific request compatibility.
|
|
374
374
|
|
|
375
|
-
By default
|
|
375
|
+
By default draht sends per-tool `eager_input_streaming: true`. If a proxy or Anthropic-compatible backend rejects that field, set `supportsEagerToolInputStreaming` to `false`. draht will omit `tools[].eager_input_streaming` and send the legacy `fine-grained-tool-streaming-2025-05-14` beta header for tool-enabled requests instead.
|
|
376
376
|
|
|
377
377
|
Some Anthropic models require adaptive thinking (`thinking.type: "adaptive"` plus `output_config.effort`) instead of the legacy budget-based thinking payload. Built-in models set this automatically. For custom providers or aliases that route to those models, set `forceAdaptiveThinking` to `true`.
|
|
378
378
|
|
package/docs/packages.md
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
|
-
>
|
|
1
|
+
> draht can help you create draht packages. Ask it to bundle your extensions, skills, prompt templates, or themes.
|
|
2
2
|
|
|
3
|
-
#
|
|
3
|
+
# draht Packages
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
draht packages bundle extensions, skills, prompt templates, and themes so you can share them through npm or git. A package can declare resources in `package.json` under the `draht` key, or use conventional directories.
|
|
6
6
|
|
|
7
7
|
## Table of Contents
|
|
8
8
|
|
|
9
9
|
- [Install and Manage](#install-and-manage)
|
|
10
10
|
- [Package Sources](#package-sources)
|
|
11
|
-
- [Creating a
|
|
11
|
+
- [Creating a draht Package](#creating-a-draht-package)
|
|
12
12
|
- [Package Structure](#package-structure)
|
|
13
13
|
- [Dependencies](#dependencies)
|
|
14
14
|
- [Package Filtering](#package-filtering)
|
|
@@ -17,40 +17,40 @@ Pi packages bundle extensions, skills, prompt templates, and themes so you can s
|
|
|
17
17
|
|
|
18
18
|
## Install and Manage
|
|
19
19
|
|
|
20
|
-
> **Security:**
|
|
20
|
+
> **Security:** draht packages run with full system access. Extensions execute arbitrary code, and skills can instruct the model to perform any action including running executables. Review source code before installing third-party packages.
|
|
21
21
|
|
|
22
22
|
```bash
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
23
|
+
draht install npm:@foo/bar@1.0.0
|
|
24
|
+
draht install git:github.com/user/repo@v1
|
|
25
|
+
draht install https://github.com/user/repo # raw URLs work too
|
|
26
|
+
draht install /absolute/path/to/package
|
|
27
|
+
draht install ./relative/path/to/package
|
|
28
|
+
|
|
29
|
+
draht remove npm:@foo/bar
|
|
30
|
+
draht list # show installed packages from settings
|
|
31
|
+
draht update # update draht, update packages, and reconcile pinned git refs
|
|
32
|
+
draht update --extensions # update packages and reconcile pinned git refs only
|
|
33
|
+
draht update --models # refresh model catalogs only
|
|
34
|
+
draht update --self # update draht only
|
|
35
|
+
draht update --self --force # reinstall draht even if current
|
|
36
|
+
draht update npm:@foo/bar # update one package
|
|
37
|
+
draht update --extension npm:@foo/bar
|
|
38
38
|
```
|
|
39
39
|
|
|
40
|
-
These commands manage
|
|
40
|
+
These commands manage draht packages, not the draht CLI installation. To uninstall draht itself, see [Quickstart](quickstart.md#uninstall).
|
|
41
41
|
|
|
42
|
-
By default, `install` and `remove` write to user settings (`~/.
|
|
42
|
+
By default, `install` and `remove` write to user settings (`~/.draht/agent/settings.json`). Use `-l` to write to project settings (`.draht/settings.json`) instead. Project settings can be shared with your team, and draht installs any missing packages automatically on startup after the project is trusted.
|
|
43
43
|
|
|
44
44
|
To try a package without installing it, use `--extension` or `-e`. This installs to a temporary directory for the current run only:
|
|
45
45
|
|
|
46
46
|
```bash
|
|
47
|
-
|
|
48
|
-
|
|
47
|
+
draht -e npm:@foo/bar
|
|
48
|
+
draht -e git:github.com/user/repo
|
|
49
49
|
```
|
|
50
50
|
|
|
51
51
|
## Package Sources
|
|
52
52
|
|
|
53
|
-
|
|
53
|
+
draht accepts three source types in settings and `draht install`.
|
|
54
54
|
|
|
55
55
|
### npm
|
|
56
56
|
|
|
@@ -59,9 +59,9 @@ npm:@scope/pkg@1.2.3
|
|
|
59
59
|
npm:pkg
|
|
60
60
|
```
|
|
61
61
|
|
|
62
|
-
- Versioned specs are pinned and skipped by package updates (`
|
|
63
|
-
- User installs go under `~/.
|
|
64
|
-
- Project installs go under `.
|
|
62
|
+
- Versioned specs are pinned and skipped by package updates (`draht update`, `draht update --extensions`).
|
|
63
|
+
- User installs go under `~/.draht/agent/npm/`.
|
|
64
|
+
- Project installs go under `.draht/npm/`.
|
|
65
65
|
- Set `npmCommand` in `settings.json` to pin npm package lookup and install operations to a specific wrapper command such as `mise` or `asdf`.
|
|
66
66
|
|
|
67
67
|
Example:
|
|
@@ -86,21 +86,21 @@ ssh://git@github.com/user/repo@v1
|
|
|
86
86
|
- HTTPS and SSH URLs are both supported.
|
|
87
87
|
- SSH URLs use your configured SSH keys automatically (respects `~/.ssh/config`).
|
|
88
88
|
- For non-interactive runs (for example CI), you can set `GIT_TERMINAL_PROMPT=0` to disable credential prompts and set `GIT_SSH_COMMAND` (for example `ssh -o BatchMode=yes -o ConnectTimeout=5`) to fail fast.
|
|
89
|
-
- Refs are pinned tags or commits. `
|
|
90
|
-
- Use `
|
|
91
|
-
- Cloned to `~/.
|
|
92
|
-
- When reconciliation changes the checkout,
|
|
89
|
+
- Refs are pinned tags or commits. `draht update` and `draht update --extensions` do not move them to newer refs, but they do reconcile an existing clone to the configured ref.
|
|
90
|
+
- Use `draht install git:host/user/repo@new-ref` to update settings and move an existing package to a new pinned ref.
|
|
91
|
+
- Cloned to `~/.draht/agent/git/<host>/<path>` (global) or `.draht/git/<host>/<path>` (project).
|
|
92
|
+
- When reconciliation changes the checkout, draht resets and cleans the clone, then runs `npm install` if `package.json` exists.
|
|
93
93
|
|
|
94
94
|
**SSH examples:**
|
|
95
95
|
```bash
|
|
96
96
|
# git@host:path shorthand (requires git: prefix)
|
|
97
|
-
|
|
97
|
+
draht install git:git@github.com:user/repo
|
|
98
98
|
|
|
99
99
|
# ssh:// protocol format
|
|
100
|
-
|
|
100
|
+
draht install ssh://git@github.com/user/repo
|
|
101
101
|
|
|
102
102
|
# With version ref
|
|
103
|
-
|
|
103
|
+
draht install git:git@github.com:user/repo@v1.0.0
|
|
104
104
|
```
|
|
105
105
|
|
|
106
106
|
### Local Paths
|
|
@@ -110,11 +110,11 @@ pi install git:git@github.com:user/repo@v1.0.0
|
|
|
110
110
|
./relative/path/to/package
|
|
111
111
|
```
|
|
112
112
|
|
|
113
|
-
Local paths point to files or directories on disk and are added to settings without copying. Relative paths are resolved against the settings file they appear in. If the path is a file, it loads as a single extension. If it is a directory,
|
|
113
|
+
Local paths point to files or directories on disk and are added to settings without copying. Relative paths are resolved against the settings file they appear in. If the path is a file, it loads as a single extension. If it is a directory, draht loads resources using package rules.
|
|
114
114
|
|
|
115
|
-
## Creating a
|
|
115
|
+
## Creating a draht Package
|
|
116
116
|
|
|
117
|
-
Add a `
|
|
117
|
+
Add a `draht` manifest to `package.json` or use conventional directories. Include the `pi-package` keyword for discoverability.
|
|
118
118
|
|
|
119
119
|
```json
|
|
120
120
|
{
|
|
@@ -156,7 +156,7 @@ If both are set, video takes precedence.
|
|
|
156
156
|
|
|
157
157
|
### Convention Directories
|
|
158
158
|
|
|
159
|
-
If no `
|
|
159
|
+
If no `draht` manifest is present, draht auto-discovers resources from these directories:
|
|
160
160
|
|
|
161
161
|
- `extensions/` loads `.ts` and `.js` files
|
|
162
162
|
- `skills/` recursively finds `SKILL.md` folders and loads top-level `.md` files as skills
|
|
@@ -165,11 +165,11 @@ If no `pi` manifest is present, pi auto-discovers resources from these directori
|
|
|
165
165
|
|
|
166
166
|
## Dependencies
|
|
167
167
|
|
|
168
|
-
Third party runtime dependencies belong in `dependencies` in `package.json`. Dependencies that do not register extensions, skills, prompt templates, or themes also belong in `dependencies`. When
|
|
168
|
+
Third party runtime dependencies belong in `dependencies` in `package.json`. Dependencies that do not register extensions, skills, prompt templates, or themes also belong in `dependencies`. When draht installs a package from npm or git, it runs `npm install`, so those dependencies are installed automatically.
|
|
169
169
|
|
|
170
|
-
|
|
170
|
+
draht bundles core packages for extensions and skills. If you import any of these, list them in `peerDependencies` with a `"*"` range and do not bundle them: `@draht/ai`, `@draht/agent-core`, `@draht/coding-agent`, `@draht/tui`, `typebox`.
|
|
171
171
|
|
|
172
|
-
Other
|
|
172
|
+
Other draht packages must be bundled in your tarball. Add them to `dependencies` and `bundledDependencies`, then reference their resources through `node_modules/` paths. draht loads packages with separate module roots, so separate installs do not collide or share modules.
|
|
173
173
|
|
|
174
174
|
Example:
|
|
175
175
|
|
|
@@ -216,7 +216,7 @@ Filter what a package loads using the object form in settings:
|
|
|
216
216
|
|
|
217
217
|
## Enable and Disable Resources
|
|
218
218
|
|
|
219
|
-
Use `
|
|
219
|
+
Use `draht config` to enable or disable extensions, skills, prompt templates, and themes from installed packages and local directories. `draht config` starts in global settings (`~/.draht/agent/settings.json`); press Tab to switch between global and project-local modes. Use `draht config -l` to start in project overrides (`.draht/settings.json`) with inherited global resources dimmed.
|
|
220
220
|
|
|
221
221
|
## Scope and Deduplication
|
|
222
222
|
|
package/docs/prompt-templates.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
>
|
|
1
|
+
> draht can create prompt templates. Ask it to build one for your workflow.
|
|
2
2
|
|
|
3
3
|
# Prompt Templates
|
|
4
4
|
|
|
@@ -6,10 +6,10 @@ Prompt templates are Markdown snippets that expand into full prompts. Type `/nam
|
|
|
6
6
|
|
|
7
7
|
## Locations
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
draht loads prompt templates from:
|
|
10
10
|
|
|
11
|
-
- Global: `~/.
|
|
12
|
-
- Project: `.
|
|
11
|
+
- Global: `~/.draht/agent/prompts/*.md`
|
|
12
|
+
- Project: `.draht/prompts/*.md` (only after the project is trusted)
|
|
13
13
|
- Packages: `prompts/` directories or `pi.prompts` entries in `package.json`
|
|
14
14
|
- Settings: `prompts` array with files or directories
|
|
15
15
|
- CLI: `--prompt-template <path>` (repeatable)
|
package/docs/providers.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Providers
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
draht supports subscription-based providers via OAuth and API key providers via environment variables or auth file. Built-in catalogs ship with draht; configured providers may refresh newer catalogs and cache them in `~/.draht/agent/models-store.json` for offline use.
|
|
4
4
|
|
|
5
5
|
## Table of Contents
|
|
6
6
|
|
|
@@ -23,7 +23,7 @@ Use `/login` in interactive mode, then select a provider:
|
|
|
23
23
|
- OpenRouter (OAuth-minted API key billed from OpenRouter credits)
|
|
24
24
|
- Radius
|
|
25
25
|
|
|
26
|
-
Use `/logout` to clear credentials. Tokens are stored in `~/.
|
|
26
|
+
Use `/logout` to clear credentials. Tokens are stored in `~/.draht/agent/auth.json` and auto-refresh when expired. OpenRouter instead mints a user-controlled API key that does not expire automatically.
|
|
27
27
|
|
|
28
28
|
### OpenAI Codex
|
|
29
29
|
|
|
@@ -63,7 +63,7 @@ Use `/login` in interactive mode and select a provider to store an API key in `a
|
|
|
63
63
|
|
|
64
64
|
```bash
|
|
65
65
|
export ANTHROPIC_API_KEY=sk-ant-...
|
|
66
|
-
|
|
66
|
+
draht
|
|
67
67
|
```
|
|
68
68
|
|
|
69
69
|
| Provider | Environment Variable | `auth.json` key |
|
|
@@ -102,11 +102,11 @@ pi
|
|
|
102
102
|
| Xiaomi MiMo Token Plan (Amsterdam) | `XIAOMI_TOKEN_PLAN_AMS_API_KEY` | `xiaomi-token-plan-ams` |
|
|
103
103
|
| Xiaomi MiMo Token Plan (Singapore) | `XIAOMI_TOKEN_PLAN_SGP_API_KEY` | `xiaomi-token-plan-sgp` |
|
|
104
104
|
|
|
105
|
-
Reference for environment variables and `auth.json` keys: [`const envMap`](https://github.com/
|
|
105
|
+
Reference for environment variables and `auth.json` keys: [`const envMap`](https://github.com/draht-dev/draht/blob/main/packages/ai/src/env-api-keys.ts) in [`packages/ai/src/env-api-keys.ts`](https://github.com/draht-dev/draht/blob/main/packages/ai/src/env-api-keys.ts).
|
|
106
106
|
|
|
107
107
|
#### Auth File
|
|
108
108
|
|
|
109
|
-
Store credentials in `~/.
|
|
109
|
+
Store credentials in `~/.draht/agent/auth.json`:
|
|
110
110
|
|
|
111
111
|
```json
|
|
112
112
|
{
|
|
@@ -198,14 +198,14 @@ export AWS_REGION=us-west-2
|
|
|
198
198
|
Also supports ECS task roles (`AWS_CONTAINER_CREDENTIALS_*`) and IRSA (`AWS_WEB_IDENTITY_TOKEN_FILE`).
|
|
199
199
|
|
|
200
200
|
```bash
|
|
201
|
-
|
|
201
|
+
draht --provider amazon-bedrock --model us.anthropic.claude-sonnet-4-20250514-v1:0
|
|
202
202
|
```
|
|
203
203
|
|
|
204
204
|
Prompt caching is enabled automatically for Claude models whose ID contains a recognizable model name (base models and system-defined inference profiles). For application inference profiles (whose ARNs don't contain the model name), set `AWS_BEDROCK_FORCE_CACHE=1` to enable cache points:
|
|
205
205
|
|
|
206
206
|
```bash
|
|
207
207
|
export AWS_BEDROCK_FORCE_CACHE=1
|
|
208
|
-
|
|
208
|
+
draht --provider amazon-bedrock --model arn:aws:bedrock:us-east-1:123456789012:application-inference-profile/abc123
|
|
209
209
|
```
|
|
210
210
|
|
|
211
211
|
If you are connecting to a Bedrock API proxy, the following environment variables can be used:
|
|
@@ -229,7 +229,7 @@ export AWS_BEDROCK_FORCE_HTTP1=1
|
|
|
229
229
|
export CLOUDFLARE_API_KEY=... # or use /login
|
|
230
230
|
export CLOUDFLARE_ACCOUNT_ID=...
|
|
231
231
|
export CLOUDFLARE_GATEWAY_ID=... # create at dash.cloudflare.com → AI → AI Gateway
|
|
232
|
-
|
|
232
|
+
draht --provider cloudflare-ai-gateway --model "claude-sonnet-4-5"
|
|
233
233
|
```
|
|
234
234
|
|
|
235
235
|
Routes to OpenAI, Anthropic, and Workers AI through Cloudflare AI Gateway. Workers AI uses the Unified API (`/compat`) and prefixed model IDs (`workers-ai/@cf/...`). OpenAI uses the OpenAI passthrough route (`/openai`) with native OpenAI model IDs such as `gpt-5.1`. Anthropic uses the Anthropic passthrough route (`/anthropic`) with native Anthropic model IDs such as `claude-sonnet-4-5`.
|
|
@@ -243,7 +243,7 @@ AI Gateway authentication uses `CLOUDFLARE_API_KEY` as `cf-aig-authorization`. U
|
|
|
243
243
|
| Stored BYOK | Cloudflare token only | Cloudflare injects provider keys stored in the AI Gateway dashboard |
|
|
244
244
|
| Inline BYOK | Cloudflare token plus upstream `Authorization` header | The request supplies the upstream provider key |
|
|
245
245
|
|
|
246
|
-
For normal
|
|
246
|
+
For normal draht usage, prefer unified billing or stored BYOK. Inline BYOK requires configuring an additional upstream `Authorization` header for the Cloudflare AI Gateway provider, for example via a `models.json` provider/model override.
|
|
247
247
|
|
|
248
248
|
### Cloudflare Workers AI
|
|
249
249
|
|
|
@@ -252,10 +252,10 @@ For normal pi usage, prefer unified billing or stored BYOK. Inline BYOK requires
|
|
|
252
252
|
```bash
|
|
253
253
|
export CLOUDFLARE_API_KEY=... # or use /login
|
|
254
254
|
export CLOUDFLARE_ACCOUNT_ID=...
|
|
255
|
-
|
|
255
|
+
draht --provider cloudflare-workers-ai --model "@cf/moonshotai/kimi-k2.6"
|
|
256
256
|
```
|
|
257
257
|
|
|
258
|
-
|
|
258
|
+
draht automatically sets `x-session-affinity` for [prefix caching](https://developers.cloudflare.com/workers-ai/features/prompt-caching/) discounts.
|
|
259
259
|
|
|
260
260
|
### Google Vertex AI
|
|
261
261
|
|
|
@@ -271,7 +271,7 @@ Or set `GOOGLE_APPLICATION_CREDENTIALS` to a service account key file.
|
|
|
271
271
|
|
|
272
272
|
## llama.cpp
|
|
273
273
|
|
|
274
|
-
|
|
274
|
+
draht supports the llama.cpp router server. Configure it with `/login llama.cpp`, manage loaded models with `/llama`, and select a loaded model with `/model`.
|
|
275
275
|
|
|
276
276
|
See [llama.cpp](llama-cpp.md) for server setup, model directory layout, environment variables, and command usage.
|
|
277
277
|
|
package/docs/quickstart.md
CHANGED
|
@@ -1,20 +1,20 @@
|
|
|
1
1
|
# Quickstart
|
|
2
2
|
|
|
3
|
-
This page gets you from install to a useful first
|
|
3
|
+
This page gets you from install to a useful first draht session.
|
|
4
4
|
|
|
5
5
|
## Install
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
draht is distributed as an npm package:
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
10
|
npm install -g --ignore-scripts @draht/coding-agent
|
|
11
11
|
```
|
|
12
12
|
|
|
13
|
-
`--ignore-scripts` disables dependency lifecycle scripts during install.
|
|
13
|
+
`--ignore-scripts` disables dependency lifecycle scripts during install. draht does not require install scripts for normal npm installs.
|
|
14
14
|
|
|
15
15
|
### Uninstall
|
|
16
16
|
|
|
17
|
-
Use the package manager that installed
|
|
17
|
+
Use the package manager that installed draht. The curl installer uses npm globally, so curl and npm installs are removed with npm:
|
|
18
18
|
|
|
19
19
|
```bash
|
|
20
20
|
# curl installer or npm install -g
|
|
@@ -30,22 +30,22 @@ yarn global remove @draht/coding-agent
|
|
|
30
30
|
bun uninstall -g @draht/coding-agent
|
|
31
31
|
```
|
|
32
32
|
|
|
33
|
-
Uninstalling
|
|
33
|
+
Uninstalling draht leaves settings, credentials, sessions, and installed draht packages in `~/.draht/agent/`.
|
|
34
34
|
|
|
35
|
-
Then start
|
|
35
|
+
Then start draht in the project directory you want it to work on:
|
|
36
36
|
|
|
37
37
|
```bash
|
|
38
38
|
cd /path/to/project
|
|
39
|
-
|
|
39
|
+
draht
|
|
40
40
|
```
|
|
41
41
|
|
|
42
42
|
## Authenticate
|
|
43
43
|
|
|
44
|
-
|
|
44
|
+
draht can use subscription providers through `/login`, or API-key providers through environment variables or the auth file.
|
|
45
45
|
|
|
46
46
|
### Option 1: subscription login
|
|
47
47
|
|
|
48
|
-
Start
|
|
48
|
+
Start draht and run:
|
|
49
49
|
|
|
50
50
|
```text
|
|
51
51
|
/login
|
|
@@ -55,37 +55,37 @@ Then select a provider. Built-in subscription logins include Claude Pro/Max, Cha
|
|
|
55
55
|
|
|
56
56
|
### Option 2: API key
|
|
57
57
|
|
|
58
|
-
Set an API key before launching
|
|
58
|
+
Set an API key before launching draht:
|
|
59
59
|
|
|
60
60
|
```bash
|
|
61
61
|
export ANTHROPIC_API_KEY=sk-ant-...
|
|
62
|
-
|
|
62
|
+
draht
|
|
63
63
|
```
|
|
64
64
|
|
|
65
|
-
You can also run `/login` and select an API-key provider to store the key in `~/.
|
|
65
|
+
You can also run `/login` and select an API-key provider to store the key in `~/.draht/agent/auth.json`.
|
|
66
66
|
|
|
67
67
|
See [Providers](providers.md) for all supported providers, environment variables, and cloud-provider setup.
|
|
68
68
|
|
|
69
69
|
## First session
|
|
70
70
|
|
|
71
|
-
Once
|
|
71
|
+
Once draht starts, type a request and press Enter:
|
|
72
72
|
|
|
73
73
|
```text
|
|
74
74
|
Summarize this repository and tell me how to run its checks.
|
|
75
75
|
```
|
|
76
76
|
|
|
77
|
-
By default,
|
|
77
|
+
By default, draht gives the model four tools:
|
|
78
78
|
|
|
79
79
|
- `read` - read files
|
|
80
80
|
- `write` - create or overwrite files
|
|
81
81
|
- `edit` - patch files
|
|
82
82
|
- `bash` - run shell commands
|
|
83
83
|
|
|
84
|
-
Additional built-in read-only tools (`grep`, `find`, `ls`) are available through tool options.
|
|
84
|
+
Additional built-in read-only tools (`grep`, `find`, `ls`) are available through tool options. draht runs in your current working directory and can modify files there. Use git or another checkpointing workflow if you want easy rollback.
|
|
85
85
|
|
|
86
|
-
## Give
|
|
86
|
+
## Give draht project instructions
|
|
87
87
|
|
|
88
|
-
|
|
88
|
+
draht loads context files at startup. Add an `AGENTS.md` file to tell it how to work in a project:
|
|
89
89
|
|
|
90
90
|
```markdown
|
|
91
91
|
# Project Instructions
|
|
@@ -95,12 +95,12 @@ Pi loads context files at startup. Add an `AGENTS.md` file to tell it how to wor
|
|
|
95
95
|
- Keep responses concise.
|
|
96
96
|
```
|
|
97
97
|
|
|
98
|
-
|
|
98
|
+
draht loads:
|
|
99
99
|
|
|
100
|
-
- `~/.
|
|
100
|
+
- `~/.draht/agent/AGENTS.md` for global instructions
|
|
101
101
|
- `AGENTS.md` or `CLAUDE.md` from parent directories and the current directory
|
|
102
102
|
|
|
103
|
-
Restart
|
|
103
|
+
Restart draht, or run `/reload`, after changing context files.
|
|
104
104
|
|
|
105
105
|
## Common things to try
|
|
106
106
|
|
|
@@ -109,8 +109,8 @@ Restart pi, or run `/reload`, after changing context files.
|
|
|
109
109
|
Type `@` in the editor to fuzzy-search files, or pass files on the command line:
|
|
110
110
|
|
|
111
111
|
```bash
|
|
112
|
-
|
|
113
|
-
|
|
112
|
+
draht @README.md "Summarize this"
|
|
113
|
+
draht @src/app.ts @src/app.test.ts "Review these together"
|
|
114
114
|
```
|
|
115
115
|
|
|
116
116
|
Images or text can be pasted with Ctrl+V (Alt+V on Windows); images can also be dragged into supported terminals.
|
|
@@ -134,32 +134,32 @@ Use `/model` or Ctrl+L to choose a model. Use Shift+Tab to cycle thinking level.
|
|
|
134
134
|
Sessions are saved automatically:
|
|
135
135
|
|
|
136
136
|
```bash
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
137
|
+
draht -c # Continue most recent session
|
|
138
|
+
draht -r # Browse previous sessions
|
|
139
|
+
draht --name "my task" # Set session display name at startup
|
|
140
|
+
draht --session <path|id> # Open a specific session
|
|
141
141
|
```
|
|
142
142
|
|
|
143
|
-
Inside
|
|
143
|
+
Inside draht, use `/resume`, `/new`, `/tree`, `/fork`, and `/clone` to manage sessions.
|
|
144
144
|
|
|
145
145
|
### Non-interactive mode
|
|
146
146
|
|
|
147
147
|
For one-shot prompts:
|
|
148
148
|
|
|
149
149
|
```bash
|
|
150
|
-
|
|
151
|
-
cat README.md |
|
|
152
|
-
|
|
150
|
+
draht -p "Summarize this codebase"
|
|
151
|
+
cat README.md | draht -p "Summarize this text"
|
|
152
|
+
draht -p @screenshot.png "What's in this image?"
|
|
153
153
|
```
|
|
154
154
|
|
|
155
155
|
Use `--mode json` for JSON event output or `--mode rpc` for process integration.
|
|
156
156
|
|
|
157
157
|
## Next steps
|
|
158
158
|
|
|
159
|
-
- [Using
|
|
159
|
+
- [Using draht](usage.md) - interactive mode, slash commands, sessions, context files, and CLI reference.
|
|
160
160
|
- [Providers](providers.md) - authentication and model setup.
|
|
161
161
|
- [Settings](settings.md) - global and project configuration.
|
|
162
162
|
- [Keybindings](keybindings.md) - shortcuts and customization.
|
|
163
|
-
- [
|
|
163
|
+
- [draht Packages](packages.md) - install shared extensions, skills, prompts, and themes.
|
|
164
164
|
|
|
165
165
|
Platform notes: [Windows](windows.md), [Termux](termux.md), [tmux](tmux.md), [Terminal setup](terminal-setup.md), [Shell aliases](shell-aliases.md).
|