Docs
Docs
Everything WhetCode does, screen by screen - the terminal, the Agentic View, the project tools and the settings.
Getting started
WhetCode is a terminal, an SSH client and an agent workspace in one app. The same account holds your plan, your workspaces and the seats you share.
- Create the account on the sign-up page, then sign in.
- Pick a plan: every plan includes the desktop client, the seat count is what changes.
- Open the console to see plan, workspace, team seats and quota in one place.
The console is member-only: without a session it redirects to the sign-in page.
Terminal and SSH
The Terminal tab is a real shell: local sessions and SSH sessions side by side, each in its own tab.
- Local shell: open a session on this machine and run commands.
- SSH: add a host once, then reconnect from the saved list instead of typing the address again.
- SFTP and FTP: browse the remote tree, upload and download files, and keep the transfer list in view.
- Tunnels and ports: forward a port from the remote host and see which tunnels are open.
- Session tabs: rename, duplicate and close sessions; the layout is restored on the next start.
Agentic View
Agentic View puts an agent next to the terminal. It runs commands, edits files and reports every step as a tool row you can open. The Terminal tab keeps the plain shell.
- Sidebar: New Task (Cmd+N), Projects, Review, Git Changes, CI/CD, Simulator.
- More: Marketplace, MCP, Scheduled Tasks, Remote Access, Workspaces.
- Tool rows: one row per tool call, open it for the command, the output and the produced diff.
- Subagents: the rail and the bar above the transcript show the children of a session and whether they are live.
- Externally running sessions: a session started outside the app shows as running and can be followed live.
- Stop: cancel a long run from the open view.
- History: sessions keep their order, merges are de-duplicated and attached images travel with the session.
Projects, Git and CI/CD
The project screens work on the repositories the app knows about.
- Projects: add a repository, switch the active project and see its branch.
- Git Changes: modified files, staged and unstaged diffs, and the commit box.
- Review: pending changes with review notes for the current work.
- CI/CD: pipeline runs, their status and the log of the selected run.
Files and search
The file screens cover both the local machine and every connected host.
- File Explorer: the local tree with create, rename, delete and open.
- SFTP browser: the same operations on a remote host, with upload and download.
- Editor: open a text file, edit and save it in place.
- Search: find text or file names in the active project and jump to the hit.
Databases
The database screens talk to the engines the host is configured for.
- DB Manager: connections, databases and collections in one tree.
- Query: run a query and read the result grid.
- The connection credentials stay on the device; the app keeps them in the credential store.
Servers and remote access
The server screens keep the machines in one list and let a phone join the same workspace.
- SSH browser: saved hosts grouped per workspace, with the connection state.
- Remote Access: pair a phone with a one-time code; paired devices stay listed.
- Workspaces: create a workspace, switch the active one and edit its settings.
- Tunnels: open ports and follow them from the same screen.
Marketplace, MCP and CLI tools
The app is extended from three places, each with its own screen.
- Marketplace: installable modules for the host, with their install state per package.
- MCP: register Model Context Protocol servers and the tools they expose to the agent.
- CLI tools: the agent CLIs the app knows, and the lock that pins their versions.
Scheduled tasks and run/debug
Two screens handle work that is not a live session.
- Scheduled Tasks: recurring jobs, their schedule and the last run.
- Run/Debug: start a configured run and read its output.
Settings
Settings opens from the gear at the bottom of the icon rail; the search field filters the pages.
- General: appearance and the defaults the app starts with.
- CLI Tools: the tool registry and its version lock.
- Control Plane: the connection to the Control Plane (endpoint and workspace key).
- AI Agents: the agents available to a session.
- AI Settings: the model providers.
- Agent Configuration: per-agent model, tools and limits.
- Advanced: the lower-level switches kept out of the everyday screens.
- About: the build, the version and the project links.
Troubleshooting and FAQ
- The pairing code is rejected: codes are single-use and expire; generate a new one.
- A saved host does not connect: check address, port and key, then reopen it from the list.
- The console shows no workspace: the account is not linked to one yet; the page says so instead of failing.
- A console card says the Control Plane is unreachable: the API-key form below stays as the fallback.
- A different seat count: change the plan; pending invites already hold a seat.