Quick Start
This guide gets you to first success: open a workspace, edit a file, run a command, and choose the next workflow.
1. Open a workspace
Choose one mode:
- Local Explorer: open a local project directory.
- Remote Explorer: connect to a project over SSH.
For SSH:
- Enter host, port, and username.
- Choose password, private-key file, or pasted private-key authentication.
- Connect.
- Confirm the workspace root path.
- Save the profile if you want quick reconnection later.
2. Open and edit a file
- Select a file from the explorer or search results.
- Edit the file in the tabbed editor.
- Save the file.
- Use outline, AI, or terminal panels when helpful.
3. Run a command
- Open the terminal.
- Run a simple verification command such as
pwd,ls, or your project’s test command. - Search terminal output if the result is long.
4. Choose your next path
Commit changes (Pro)
Use Source Control to review diffs, stage changes, commit, and sync with remote branches.
Ask AI
Use AI Chat for explanations and planning. Use AI Agent for multi-step work. Agent usage is metered on Free and unlimited on Pro.
Diagnose a problem (Pro for advanced tools)
Use LSP diagnostics, code actions, Debug, and Timeline AI when a problem requires deeper investigation.
Automate repeated commands
Use Tasks for repeated terminal-backed workflows. Advanced filtered and parallel task runs are Pro capabilities.