Start here
Install Matrix, open the workspace, and try one simple task.
Install the Mac preview, open the Dashboard, and choose one tool. You can add provider details later when a tool needs them.
Step-by-step guides
Choose the help you need.
Each card moves to clear steps on this page.
Start
Install Matrix
Download and install the current Mac preview.
Read stepsStart
First launch
Find the Dashboard and check what is ready.
Read stepsSetup
Choose tools
Add only the tools that match your work.
Read stepsSetup
Provider setup
Connect an AI provider or local option when a tool asks for one.
Read stepsWorkflow
Flow
Plan software work and review each result.
Read stepsWorkflow
Chat
Ask questions and work through ideas in one conversation.
Read stepsWorkflow
Whispr
Turn speech into text when typing is inconvenient.
Read stepsWorkflow
Code and Git
Inspect code and Git changes before keeping them.
Read stepsWorkflow
Social Studio
Prepare social content and review it before use.
Read stepsSupport
Privacy
Understand what stays local and what an external provider receives.
Read stepsWorkflow
Review
Check AI-assisted work before accepting or sharing it.
Read stepsSupport
Troubleshooting
Work through common Matrix problems in a safe order.
Read stepsStart
Install Matrix
Download and install the current Mac preview.
- Open Downloads and choose Apple Silicon or Intel to match your Mac.
- Check the posted SHA-256 value if you need to verify the file, then open the DMG and move Matrix to Applications.
- On first open, follow the macOS prompt for this ad-hoc signed, non-notarized preview.
Start
First launch
Find the Dashboard and check what is ready.
- Open Matrix from Applications and wait for the Dashboard to appear.
- Check the service and tool status shown there before starting work.
- Open one tool for a small first task; other tools can stay closed until needed.
Setup
Choose tools
Add only the tools that match your work.
- Use Flow for planned software tasks, Chat for conversation, and Whispr for spoken notes.
- Use Code and Git when you need to inspect code or changes, and Social Studio for reviewed social drafts.
- Open Design and Exo are upstream-mounted tools; Research is a shared ability used through other tools.
Setup
Provider setup
Connect an AI provider or local option when a tool asks for one.
- Choose the provider you already use or a local option that Matrix supports.
- Enter provider details in the setup area shown by the tool; Models-Cline is setup information, not a separate product.
- Before sending a prompt, check which text or files may leave your device for that provider.
Workflow
Flow
Plan software work and review each result.
- Add the project folder you want Flow to work with and create a task with a clear result.
- Start the task, watch its progress, and read any question before allowing more work.
- When it finishes, inspect the output and continue with the Review guide before accepting changes.
Workflow
Chat
Ask questions and work through ideas in one conversation.
- Open Chat and choose the provider or model needed for the conversation.
- Write a focused question and add only the context that is safe and useful to share.
- Read the answer as advice, and check important facts before acting on them.
Workflow
Whispr
Turn speech into text when typing is inconvenient.
- Open Whispr and allow microphone access only when macOS asks for it.
- Start a recording, speak clearly, and stop when the note or prompt is complete.
- Read and edit the transcript before using it elsewhere.
Workflow
Code and Git
Inspect code and Git changes before keeping them.
- Open the project and confirm that Matrix is showing the folder you meant to use.
- Read changed files and the Git diff; do not accept a change only because an AI created it.
- Run the project's checks before committing or sharing the result.
Support
Privacy
Understand what stays local and what an external provider receives.
- Matrix keeps supported workspace information on your device, but connected providers follow their own data rules.
- Before using a provider, check its settings and avoid sending secrets, private customer data, or files it does not need.
- Use the Privacy page for website-data questions and the provider's policy for provider-data questions.
Workflow
Review
Check AI-assisted work before accepting or sharing it.
- Compare the requested result with what the tool actually produced.
- Inspect changed files, commands, sources, and links, then run the relevant checks.
- Keep, revise, or reject the result; a completed tool run is not automatic approval.
Support
Troubleshooting
Work through common Matrix problems in a safe order.
- Confirm the Matrix version, your Mac type, and the exact tool that is failing.
- Return to the Dashboard and check service, provider, and tool status before retrying.
- If the problem remains, note the safe error text and contact Support without sending passwords, keys, or private files.
Useful pages
Workflow
Social Studio
Prepare social content and review it before use.
- Choose the idea or source material for the draft and remove private information.
- Create a draft for the intended audience and channel.
- Check claims, tone, links, and media rights before you copy or publish anything.
Back to all guides