summaryrefslogtreecommitdiff
path: root/docs
AgeCommit message (Collapse)Author
2026-07-02Remove hexai-tmux-edit popup editor featurev0.42.0Paul Buetow
The tmux popup editor and its per-agent detection (Cursor/Amp/Aider) added maintenance surface without enough use to justify it; Codex and Claude Code already support external-editor mode natively via Ctrl+G. Drops internal/tmuxedit, cmd/hexai-tmux-edit, the [tmux_edit] config schema, the Mage build target, and all related docs/README mentions. Bump version to 0.42.0. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-05-26feat(askcli): add projects subcommandPaul Buetow
2026-05-26feat(askcli): add watch subcommandPaul Buetow
Implements `ask watch [subcommand...]` which re-runs a read-only subcommand every 2 seconds and redraws output when it changes, similar to gnu-watch. Safety features: - Restricted to read-only subcommands (list, all, ready, info, urgency, help, dep list) - Recursive watch is blocked - Captures stderr so error messages are visible in the watched display Also adds readOnly field to commandEntry registry for maintainability.
2026-05-20docs: document You.com (YouSearch) providerPaul Buetow
Amp-Thread-ID: https://ampcode.com/threads/T-019e45ff-4976-750c-b2e6-121d0e5991ef Co-authored-by: Amp <amp@ampcode.com>
2026-05-02Drop hexai edit; document hexai config only.v0.38.4Paul Buetow
The CLI now opens the config file only via hexai config (and --config). README, usage, and configuration docs describe the subcommand. Version 0.38.4. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-04-26feat: default to Ollama Cloud (kimi-k2.6) when no provider configuredPaul Buetow
Switches the in-code defaults so that hexai talks to Ollama Cloud (https://ollama.com) with model kimi-k2.6 when no provider is configured, instead of OpenAI. The example config, README, and configuration guide all reflect the new recommended setup; previous OpenAI / local-Ollama options are still documented as alternatives. Tests that depended on the implicit "openai" default now pin the provider explicitly so they continue to exercise the OpenAI / gpt-5 code paths they were designed to cover. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-25docs: update documentation for popup, fix_typos, and configurable menuPaul Buetow
- README: expand hexai-tmux-action bullet with popup mode, all built-in hotkeys, configurable menu, and overridable prompts - configuration.md: update TUI section (split→popup, new popup flags, configurable menu example, prompt key-prefix table) - usage.md: update Hexai Action section with full hotkey table and configurable menu mention Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-11docs: align Fish completion with manual load onlyPaul Buetow
Clarify that mage install and go install do not write fish/completions, document removing stale ask.fish from older installs, and cross-link README, buildandinstall, and usage. Made-with: Cursor
2026-04-11Release v0.31.1: stop installing Fish ask.fish on mage installv0.31.1Paul Buetow
mage install no longer writes ~/.config/fish/completions/ask.fish; use ask fish | source or a conf.d snippet per docs/fish-completion.md. Made-with: Cursor
2026-04-11Rename task CLI binary from do back to askPaul Buetow
- Move cmd/do to cmd/ask; mage builds and installs ask; Fish completions to ask.fish - Update askcli help text, errors, executor default label, and Fish script (__ask_*) - Task alias cache subdirectory under XDG cache: hexai/ask/ - Rename integration test files and helpers; refresh README and docs - Rename plan-do-uuid-wrapper.md to plan-ask-uuid-wrapper.md Made-with: Cursor
2026-04-10release: v0.30.0v0.30.0Paul Buetow
2026-04-10task 30: add proj prefix override for doPaul Buetow
2026-04-10task 20: hide do info UUID unless HEXAI_DEBUG is setPaul Buetow
2026-04-08fish: complete task selectors with short aliases onlyPaul Buetow
Add complete-aliases subcommand that emits tab-separated alias lines without UUID duplicates. Wire embedded Fish script (__do_task_selectors) to call complete-aliases; keep complete-uuids unchanged for scripts and tests. Made-with: Cursor
2026-04-08docs: align task CLI docs with do rename from askPaul Buetow
Rename plan-ask-uuid-wrapper.md to plan-do-uuid-wrapper.md and note the former binary name. Clarify install line, README entrypoint, and usage task-management section so scripts and examples consistently use do. Made-with: Cursor
2026-04-08Rename task CLI from ask to doPaul Buetow
- Move cmd/ask to cmd/do; mage BuildDo builds binary named do - Update askcli help text, errors, Fish completion (complete -c do, __do_*) - Task alias cache path: XDG cache hexai/do/task-aliases-v2.json - Refresh README and docs; go install path cmd/do@latest - Remove accidentally tracked cmd/ask build artifact; ignore cmd/do/do and cmd/do/ask Made-with: Cursor
2026-04-07feat: remove tmux edit popup support for Claude CodePaul Buetow
Claude Code CLI now supports Ctrl+G to open the prompt in EDITOR (like OpenAI Codex CLI), making the built-in hexai-tmux-edit agent profile redundant. - Remove internal/tmuxedit/claude_agent.go and its tests - Update builtinAgents() to exclude claude; built-ins are now: cursor, amp, aider - Update all documentation (README, docs/tmux.md, docs/usage.md, docs/configuration.md) - Update config.toml.example to reflect new agent list Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-27release: v0.27.2v0.27.2Paul Buetow
2026-03-27release: v0.27.1v0.27.1Paul Buetow
2026-03-27askcli: support add depends selectorsPaul Buetow
2026-03-27fix ask add alias output for 1a1731dc-1f11-42bd-be12-4c1af7f7e673Paul Buetow
2026-03-27Verify fish selector completion coverage for ↵Paul Buetow
6c1f2f60-d55c-4a0c-ba5d-e897c738ecb4
2026-03-27task 73fabcf6-d4a1-4bf3-aae1-a390a734e517: extend ask selector completionPaul Buetow
2026-03-27askcli: show task aliases in output (cd322ed1-882d-40e9-ab98-689acd5f161e)Paul Buetow
2026-03-26Implement ask started-task info 4c3640dc-3730-40c9-bfa6-db90564e3171Paul Buetow
2026-03-26release: v0.26.1v0.26.1Paul Buetow
2026-03-26ask: filter fish UUID completionPaul Buetow
2026-03-26ask: add fish UUID completionsPaul Buetow
2026-03-26ask: add fish completions for task CLIPaul Buetow
2026-03-23docs: update usage.md for ask list/all commandsPaul Buetow
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-22docs: update README and usage.md with new ask subcommandsPaul Buetow
2026-03-22Add skill migration and Taskwarrior leakage audit to ask wrapper planPaul Buetow
Amp-Thread-ID: https://ampcode.com/threads/T-019d1407-6145-7534-b780-29a2559d06c5 Co-authored-by: Amp <amp@ampcode.com>
2026-03-22Add modify, denotate, and start field to ask wrapper planPaul Buetow
Amp-Thread-ID: https://ampcode.com/threads/T-019d1407-6145-7534-b780-29a2559d06c5 Co-authored-by: Amp <amp@ampcode.com>
2026-03-22Add delete, export, and list filter/sort/limit to ask wrapper planPaul Buetow
Amp-Thread-ID: https://ampcode.com/threads/T-019d1407-6145-7534-b780-29a2559d06c5 Co-authored-by: Amp <amp@ampcode.com>
2026-03-22Add plan document for ask UUID-only Taskwarrior wrapperPaul Buetow
Amp-Thread-ID: https://ampcode.com/threads/T-019d1407-6145-7534-b780-29a2559d06c5 Co-authored-by: Amp <amp@ampcode.com>
2026-03-22Remove 'hexai task' references from docsPaul Buetow
Amp-Thread-ID: https://ampcode.com/threads/T-019d1407-6145-7534-b780-29a2559d06c5 Co-authored-by: Amp <amp@ampcode.com>
2026-03-19Add ask Taskwarrior wrapperPaul Buetow
2026-03-15Release v0.23.0v0.23.0Paul Buetow
2026-03-14Release v0.22.1v0.22.1Paul Buetow
2026-03-13release: v0.22.0v0.22.0Paul Buetow
2026-02-22docs: clarify Codex uses native Ctrl+G external editorPaul Buetow
2026-02-13chore: deprecate hexai-mcp-server as experimentalPaul Buetow
Add deprecation notices across hexai-mcp-server codebase and documentation. The MCP server is now considered experimental and not actively maintained, as prompts are managed through slash commands and meta-commands instead. Changes: - Add runtime deprecation warning to stderr on binary startup - Mark feature as deprecated in README.md - Add deprecation notices to all 8 MCP documentation files - Add deprecation log message to run.go - Update Magefile.go build comment The code remains fully functional but warns users of its experimental status. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-12feat: add design_prompt meta-prompt for implementation planningPaul Buetow
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-12Rename hexai-lsp command to hexai-lsp-serverPaul Buetow
Amp-Thread-ID: https://ampcode.com/threads/T-019c50bc-2906-77db-a31e-0d553338d99b Co-authored-by: Amp <amp@ampcode.com>
2026-02-11refactor: compile built-in prompts into binary instead of external filesPaul Buetow
This change moves built-in meta-prompts (save_prompt, update_prompt) from external JSONL files into compiled Go code, making them always available and version-controlled with the binary. Changes: - Add default_prompts.go with built-in meta-prompt definitions - Update store to load built-ins from code, not files - Add protection: built-ins cannot be updated/deleted - Handle name conflicts: built-ins take precedence with warnings - Update docs to reflect new architecture (no default.jsonl needed) - Add comprehensive tests for built-in protection - Add hexai-mcp-server binary to .gitignore Benefits: - Built-ins always in sync with binary version - No setup required (no default.jsonl to manage) - Clear separation between built-in and user prompts - Protection prevents accidental modification of meta-prompts Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-11docs: update all paths to consolidated .local/hexai directoryPaul Buetow
Update all documentation to reflect new directory structure: - Cache: ~/.local/hexai/cache/ - State: ~/.local/hexai/state/ - Data: ~/.local/hexai/data/ Updated files: - README.md - docs/mcp-setup.md - docs/mcp-prompts.md - docs/mcp-managing-prompts.md - docs/mcp-features-summary.md - docs/mcp-automatic-backups.md - docs/mcp-server-complete.md Amp-Thread-ID: https://ampcode.com/threads/T-019c4e03-73db-70a2-ae27-3e1cc31d59c3 Co-authored-by: Amp <amp@ampcode.com>
2026-02-11Fix MCP transport to use JSONL instead of Content-Length framingPaul Buetow
The MCP stdio protocol uses newline-delimited JSON (JSONL), not LSP-style Content-Length headers. This was discovered during integration testing with Claude Code CLI which could not connect to the server. Also updates docs/mcp-setup.md with correct Claude Code CLI configuration (use `claude mcp add` instead of editing JSON files) and adds integration test runbook for testing against real Claude Code CLI instances. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-10Add MCP server implementation with comprehensive test coveragePaul Buetow
Implements a full Model Context Protocol (MCP) server for managing and serving prompts to LLM applications. The server provides CRUD operations for prompts with automatic backups and template rendering support. Key additions: - cmd/hexai-mcp-server: Main MCP server binary entrypoint - internal/hexaimcp: Server orchestrator with configuration and setup - internal/mcp: Core MCP protocol implementation (JSON-RPC 2.0) - internal/promptstore: Prompt storage with JSONL backend and automatic backups - Comprehensive test suites achieving 80%+ coverage for all MCP packages - Magefile targets for building and installing the MCP server - Complete documentation for setup, API, prompts, and backups Test coverage: - internal/hexaimcp: 84.3% - internal/mcp: 80.3% - internal/promptstore: 81.2% - Overall project: 81.5% Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-10Fix hexai-tmux-edit to open in current working directoryPaul Buetow
hexai-tmux-edit was opening in the wrong directory because the tmux popup wasn't being told which directory to use. This fix: - Updates bind-key example to cd into pane's current path - Passes working directory to popup via -d flag using os.Getwd() - Updates all documentation with corrected bind-key examples Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-08chore: stop tracking build artifacts and temp filesPaul Buetow
Co-authored-by: Cursor <cursoragent@cursor.com>