Skip to main content

Start a new task

Choose Coding or General, associate a project, and start a Qoder task.

Qoder provides two work modes: Coding and General. Both provide the Agent, models, access permissions, context, and attachments. The main differences are whether tasks are organized by workspace or folder and whether the composer provides engineering options such as the execution mode and branch.

Choose a work mode

ComparisonCodingGeneral
Task organizationGroups tasks by WorkspacesGroups tasks by Folders
Project entrySelect or add a workspaceSelect or add a folder
ComposerAfter selecting a workspace, confirm Local or Worktree and the current branchSelect a folder, or continue without one when local files are not required
Use Coding when you need to edit code, run project commands, work on a Git branch, or isolate parallel work in a Worktree. Use General for research, document handling, content work, and other tasks whose natural boundary is a folder. A mode does not restrict what you can ask; switch modes and select a more suitable workspace or folder when the nature of the work changes.
Go to Settings → Mode configuration to change each mode's bound theme and the visibility of run locations, environment labels, task-card details, Browser local services, and file-change cards.
To learn how to use a feature, type / in a local task, find and select qoder-helper, and ask your question, such as “What is the difference between Coding and General modes?” It explains product features and where to find them. To check or change settings, see Find or change settings through conversation. For help with an issue, see Troubleshooting. qoder-helper supports local tasks, not Remote SSH or WSL remote tasks.

Choose a workspace and execution location

Choose a workspace based on where your project is located. This determines where the task reads files, runs commands, and saves project changes.
EnvironmentWhere changes are madeUse it when
Local workspaceThe open project directory on this deviceYou need a small change, fast verification, or immediate access to the result.
WorktreeA separate Git worktreeYou are running parallel tasks or isolating a larger change from the current checkout.
SSH workspaceA directory on a registered remote hostThe code, dependencies, or runtime exist only on that host.
WSL workspaceA Linux directory in a WSL distribution on WindowsYour project is in WSL and should run in its Linux environment.
Another deviceA workspace authorized by that deviceRun tasks on another device that has Qoder running.
No workspaceNo project directoryThe task does not need project files or commands.

Create a task

1

Choose a mode

Select Coding or General in the upper-left corner. The project area in the sidebar changes to Workspaces or Folders.
2

Associate a project

A new task uses the device selected in the sidebar. Check the execution device before choosing a workspace. In Coding, select an existing workspace or add a project, then check the execution mode and branch in the composer. In General, choose or add a folder, or leave it empty if the task needs no files.When you first add an untrusted folder, review each directory path in the confirmation before you trust the folders. In an authorized workspace on a connected device, you can browse files, use the available terminal or browser, and check that attachments are ready before sending.
3

Describe the outcome

In the New Task composer, state the expected result, allowed scope, constraints, and validation method. Use Add context or Add attachment when files, images, or other evidence are needed.
4

Choose an agent or team

At the top of the new task page, click the current executor name (Qoder by default) to open the picker to select an existing Agent or custom agent team to run the task.
5

Confirm run settings

Select a model and review Access permissions for the operations this task may perform. Start voice input or Live voice when needed.
6

Send and review

After sending, review the Agent response, tool calls, and file changes. Continue with specific feedback, then run the agreed validation and review the Diff.Use the task monitor to follow progress and outputs, open files to inspect the results, and review code changes before committing.

Create a task from a PPT template

Install and enable the official PPT plugin, then select its capability through Add context or the / menu in the new-task composer. Preview and choose a template available to your account. Once the attachment is ready, add the topic, audience, and content requirements, or send it directly. Check the execution environment before choosing a template. See Start from a PPT template for the steps and remote resource limits.

Generate images and videos

  • Video generation is available only to users on a paid plan. Free plan and Pro trial users cannot generate videos.
  • Image and video generation are currently unavailable when using models connected with your own API key (BYOK).
To create an illustration or video, describe the subject, purpose, and style in a task. For example: “Generate a simple illustration for a product introduction page, without text,” or “Generate a short video of a sunset over the sea, with the camera moving slowly forward.” Specify whether you want an image or a video, then describe the subject, scene, and elements to avoid. Open the generated result to review it, and describe any changes you want in a follow-up message. For video progress and playback, see Check generated videos.

Start a task from a local file

Start from your file manager when you want Qoder to work with a local file.
  1. Select a supported file and choose Open with → Qoder.
  2. In the new task draft, check the attachment and associated workspace or folder.
  3. Describe what you want, such as “Summarize the key findings in this document.” Review access permissions, then send.
Opening a file prepares a draft; it does not send a task or perform file operations automatically. If Qoder is not offered, open the app and use Add attachment in the composer. The system entry requires an installed Qoder app that has registered the file type. If you already have a draft for a regular new task, opening a file appends it as an attachment. Your text, existing attachments, and workspace selection stay in the draft. Review all attachments before sending.

Write an effective instruction

Start with the outcome, then add success criteria, relevant files, constraints, and validation. Specify detailed steps only when the exact execution path is required.
Add a responsive project gallery to the existing website.
Reuse the current colors and components. Include a project list, filters, and detail links. Do not change sign-in or payment flows.
Check wide and narrow layouts, run the existing tests, and report the changes and validation results.

Continue or separate the work

Use the same task when you are refining the same outcome and the existing context still applies. Start a separate task when the goal, workspace, execution boundary, or success criteria change. This keeps each task easier to review, search, and archive. To add requirements while a task runs, queue or steer a message. Use Task management to organize, archive, or return to the work afterward.