Skip to content
Wordless Docs

Core concepts

Workspace and local-first behavior

Section titled “Workspace and local-first behavior”

Each session is bound to a workspace. File references, Workspace Files, and Default Access use that directory as their boundary. Wordless sends the task and necessary context to the model provider you selected; local files are not uploaded to Wordless automatically.

Composer references

Section titled “Composer references”
Type @ to search workspace files, filtered by .gitignore when present. Use ↑/↓ and Enter to insert a token; Esc closes the list.

Tokens are structured context, not plain path text. Focusing a token replaces its leading icon with the remove action.

Approvals and access

Section titled “Approvals and access”
  • Manual approve is the default: each tool requiring approval is explicitly allowed.
  • Auto-approve for this session applies only to ordinary-risk actions in the current session. A high-risk card disables it and requires a manual decision.
  • Default Access limits file operations to the workspace.
  • Full Access expands the boundary and should be used only when the impact is understood.
  • One-time elevation permits one named operation while keeping Default Access afterward.

Sessions, search, and compaction

Section titled “Sessions, search, and compaction”

Wordless stores user messages, model messages, and tool states locally. Long contexts may be compacted; that does not create a new user task. Message search highlights the matching keyword and scrolls the virtual list to the exact message. With an empty Composer, ↑ and ↓ move through user-message history.

Models and thinking depth

Section titled “Models and thinking depth”

Clicking a model selects it immediately. Only the selected model exposes its supported thinking-depth submenu. If you do not choose a value, medium is used; unsupported models do not show the control.