Daml Coding Assistant

A code assistant for Daml development.

Features

• Ghost Text Autocompletion: Suggests completions based on your cursor position in .daml files.
• Feedback Loop: Automatically reports accepted suggestions to the inference server. Code content can be kept out of the server's logs with the daml-coding-assistant.shareCodeSnippets setting.

Getting started

1. Install Daml Coding Assistant from the VS Code Marketplace (Extensions view → search "Daml Coding Assistant"). Installing from a downloaded .vsix file also works: Extensions view → ... menu → Install from VSIX....
2. On first start it prompts you to sign in — click Sign in (or run Daml Coding Assistant: Log In any time). A browser window opens for login; new users can register there (email + password, or Google). After an administrator approves your account, completions start working — until then the extension shows a one-time "registered but not yet approved" notice.
3. Open a .daml file and start typing. Completions appear inline.

Usage

• Open a .daml file.
• Default behavior is daml-coding-assistant.triggerMode = automatic: suggestions appear while typing.
• For manual mode, set daml-coding-assistant.triggerMode = manual, then run VS Code's inline trigger action:
  • Command: Trigger Inline Suggestion (editor.action.inlineSuggest.trigger)
  • On macOS this is often Option+Backslash by default.
  • On Windows/Linux, the keybinding depends on your VS Code keymap and custom bindings.

The trigger/accept/partial-accept keys are VS Code editor shortcuts, not extension-specific keybindings.

Finding and changing shortcuts

Open Keyboard Shortcuts in VS Code:

• macOS: Code -> Settings -> Keyboard Shortcuts (or Cmd+K Cmd+S)
• Windows/Linux: File -> Preferences -> Keyboard Shortcuts (or Ctrl+K Ctrl+S)

Search for these inline suggestion commands:

• Trigger Inline Suggestion (editor.action.inlineSuggest.trigger)
• Accept Inline Suggestion (editor.action.inlineSuggest.commit)
• Accept Next Word Of Inline Suggestion (editor.action.inlineSuggest.acceptNextWord) for partial accept
• Accept Next Line Of Inline Suggestion (editor.action.inlineSuggest.acceptNextLine) for partial accept
• Show Next Inline Suggestion (editor.action.inlineSuggest.showNext)
• Show Previous Inline Suggestion (editor.action.inlineSuggest.showPrevious)

Commands

• Daml Coding Assistant: Log In — sign in via the browser.
• Daml Coding Assistant: Log Out — clear the stored token and end the browser (Keycloak) session so a different user can sign in.
• Daml Coding Assistant: Auth Status — show whether you are signed in.
• Daml Coding Assistant: Account Menu — the actions above in one menu; also opens from the Daml Coding Assistant status-bar item.

Note: uninstalling the extension does not clear the stored login — VS Code keeps extension storage for reinstalls. Run Daml Coding Assistant: Log Out before uninstalling to fully sign out.

Terms and privacy

Use of the hosted service is subject to the Terms of Use; data handling is described in the Privacy Notice.

Settings

All settings have working defaults; you normally do not need to change any of them.

• daml-coding-assistant.triggerMode (default: automatic; values: automatic, manual)
• daml-coding-assistant.shareCodeSnippets (default: off; the extension asks for your choice on first use) — share code with the server to help improve the model: the context around your cursor and accepted completion text are kept in the server's logs. When off, no code content from your requests is retained; anonymous metrics (accept/reject, character counts, latency) are still reported. Completions work normally either way.
• daml-coding-assistant.serverUrl (default: https://api.dca.catalyx.solutions) — the inference server to use.
• daml-coding-assistant.oidcDiscoveryUrl — Keycloak realm discovery URL. Advanced: change only when pointing at a different environment.
• daml-coding-assistant.oidcClientId — OIDC public client ID. Advanced: change only when pointing at a different environment.