@@ -12,9 +12,9 @@ A coding agent via a augmented shell prompt, small and fast that doesn't get in
1212 ## Philosophy:
1313
1414 Very focused on dev flow, simple setup steps and fast to coding.
15-Elegant output that focus on the conversation with the agent and their actions.
15+Elegant output that focus on the conversation with the agent and their actions. Ensure an accurate cronological conversation log that is very readable for the user.
1616 Accurate and reliable core set of features.
17-Fast and performant
17+Fast and performant, instant feedback shell like output. Performance first style second.
1818 Community oriented, all of the inspirations have their own dotfile format, try to follow the existing
1919 conventions and not introduce more specs. (`.agents` / `AGENTS.md`, while also supporting adjacent conventions like `.claude`)
2020
@@ -37,10 +37,10 @@ conventions and not introduce more specs. (`.agents` / `AGENTS.md`, while also s
3737 - `/reasoning` toggles display of model reasoning output.
3838 - `/context` configures context pruning and tool-result caps.
3939 - `/review` reviews recent changes via a global command installed at app start (`~/.agents/commands/review.md`), and can be customized or shadowed locally.
40- - `/ralph` for a ralph loop mode (by Geoffrey Huntley, who described it simply: “Ralph is a Bash loop.”)
4140 - `/agent` sets or clears the active primary agent.
4241 - `/mcp` list/add/remove mcp servers. servers are stored in sqlite
43- - `/new` starts a new session with clean context.
42+ - `/new` starts a new session with clean context. Clean UI and fresh session display
43+ - `/_debug` hidden command that snapshots recent logs/db and creates a report in the cwd. For dev mostly but available to all. Do not list it anywhere, only documented here and in the code itself.
4444 - Connect to MCP servers over Streamable HTTP / SSE fallback or stdio.
4545 - Image support in prompt input, including pasted image data URLs and pasted image file paths.
4646 - Excellent auto complete for all commands, subtituitions. The user should also be able to reference files with autocomplete wihtout including them into the prompt like `@` does with TAB
@@ -49,6 +49,7 @@ conventions and not introduce more specs. (`.agents` / `AGENTS.md`, while also s
4949
5050 - Use the 16 ANSII colors so the coloring is allways inherited from the terminal theme (https://jvns.ca/blog/2024/10/01/terminal-colours/)
5151 - Use pi and claude code as visual inspirations.
52+- Banner at app start, show found configs and context files
5253 - history log (like a terminal output scrolls away, pushing the input prompt down)
5354 - Read tool show the tool call with args fomatted for output
5455 - Edit tools show the diff applied
@@ -61,6 +62,7 @@ conventions and not introduce more specs. (`.agents` / `AGENTS.md`, while also s
6162 - All things Bun.js, runtime, package manager. https://bun.com/docs
6263 - Multiprovider support via https://ai-sdk.dev/docs/introduction
6364 - Colored output with https://github.com/sindresorhus/yoctocolors limitted but fast!
65+- Markdow rendering support without sacrificing speed and performance
6466
6567 ## Repo structure