Using Aldwin
Chat, approvals, workspace, memory, and everyday terminal flow.
On this page
Open a terminal, type aldwin, and talk in plain language. Aldwin streams the reply, shows tool steps as they run, and asks before risky actions.
Conversations, memory, and settings are shared with the web app, so a chat you start here also shows up in the browser.
Chat basics#
- Enter sends the message. While Aldwin is working, Enter queues the next one.
- Alt+Enter, Shift+Enter, or Ctrl+J inserts a new line.
- Esc stops an answer, closes an overlay, or clears a draft (double Esc).
- ? on an empty prompt shows shortcuts in the footer.
- ↑ / ↓ walk history, or move in slash and approval lists.
- Ctrl+R searches input history.
- Ctrl+C clears the draft; twice on an empty prompt saves and exits.
- Ctrl+D saves and exits.
Workspace#
Aldwin works inside a folder. Check or change it with /workspace. Point it at the project or notes vault you mean before asking for edits. See Workspace and files.
Approvals#
When Aldwin wants to run a shell command, download a file, edit or write a file, change persona, forget a memory, or save a skill, you get a yes or no or a diff. Read it. Approve only what you expect. The default answer is no. See Safety.
Memory and persona#
Aldwin can save short lasting facts and a persona file. Use natural language (“remember that…”) or /memory and /persona to inspect. Forget something on purpose when it goes stale. See Memory and persona.
Skills#
Skills are short playbooks Aldwin loads for jobs like files, documents, web research, or the shell. Type @ to pick one, or /skills to list them. Ask Aldwin to learn a routine and it can draft a skill for you (with approval). The full list is on Skills and tools.
Connectors#
Type /connectors to add Notion, Linear, GitHub, and other apps. Sign in when asked. After that, ask in normal language. Details: Connectors.
Models#
/model switches local and cloud providers. Details: Models.
Setup that works well#
- Set the workspace to the right folder.
- Pick a tool-capable model.
- Add connectors you use every week.
- Tell Aldwin a few durable preferences once.
- Let long chats run: Aldwin makes room on its own, and
/compactdoes it now. Use/newwhen you change subject; memory notes carry over.
More command detail: Slash commands.