> ## Documentation Index
> Fetch the complete documentation index at: https://agent.minimax.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Tasks and History

> Manage tasks, history, pinned items, and archived conversations in MiniMax Code.

<div className="code-docs">
  Every conversation creates a task record. The sidebar lets you switch tasks, search history, pin important items, and archive completed work.

  Desktop-cloud collaboration brings local and cloud tasks together in MiniMax Code. Choose where a task runs, return to existing conversations, or send a local task's context and selected files to the cloud. When results are ready, you can view and download cloud outputs in the desktop app; when cloud work changes local project files, review the changes before writing them back to your workspace.

  <img src="https://mintcdn.com/agent-en/yEQNl2mVInzXN9Xt/images/code/sidebar-history.png?fit=max&auto=format&n=yEQNl2mVInzXN9Xt&q=85&s=aa30cc85decce0934aa2896efe6fc3b9" alt="Left sidebar task history" className="code-screenshot" width="2802" height="1700" data-path="images/code/sidebar-history.png" />

  ## Local, Cloud, and Task Handoff

  <img src="https://mintcdn.com/agent-en/Oyv_kdAZLmHKIw9C/images/code/cloud-sessions.png?fit=max&auto=format&n=Oyv_kdAZLmHKIw9C&q=85&s=2a77c41e661fe3f635d608d9a8b290d8" alt="Local and cloud session list" className="code-screenshot" width="1078" height="1459" data-path="images/code/cloud-sessions.png" />

  The desktop session list includes both local and cloud sessions, with local/cloud controls for viewing each task list. You can start cloud work from the desktop app, open existing cloud projects or conversations, follow task progress, and download generated files or other outputs after the task completes.

  For local tasks that are already in progress, start a handoff from the current conversation. MiniMax Code prepares the task context and recommends files and folders to upload. Before upload, you can confirm the recommended resources, deselect anything unnecessary, or add more files from the current workspace, then let the cloud Agent continue the work.

  <img src="https://mintcdn.com/agent-en/Oyv_kdAZLmHKIw9C/images/code/cloud-handoff.png?fit=max&auto=format&n=Oyv_kdAZLmHKIw9C&q=85&s=c725034aa8e5fc2b714b8437159d9587" alt="Recommended resources for continuing a local task in the cloud" className="code-screenshot" width="1700" height="402" data-path="images/code/cloud-handoff.png" />

  | Session type | Description |
  | - | - |
  | Local session | Runs on the current device and workspace. Best when the task needs local files, terminal access, or the browser. |
  | Cloud session | Runs in the cloud. Best when work should continue away from the local machine or when you need to review cloud results. |

  ### How to Use It

  <Steps>
    <Step title="Choose where your task runs">
      Create a new conversation in the MiniMax Code desktop app and select the cloud option using the local/cloud control near the message box. You can choose a cloud project if needed. If the task needs files from your computer, attach them before sending.
    </Step>

    <Step title="Describe your task">
      Tell the Agent what you need it to do. If the task requires files from your computer, attach them before sending your request.
    </Step>

    <Step title="Check progress and continue the conversation">
      Open the cloud conversation in the desktop app to see the Agent's responses and progress. You can add information, request changes, or return to the task later from the conversation list.
    </Step>

    <Step title="View and download files">
      Once results are available, you can view them in the conversation. Use the download option to save any files you want to keep or work with on your computer.
    </Step>

    <Step title="Hand off a local task">
      For a task with a local workspace selected, type `/` in the message box and choose Continue in Cloud. Describe what should happen next, review the recommended resources card, and confirm the files before starting the handoff.
    </Step>

    <Step title="Sync cloud changes">
      If the cloud task changes files related to your local project, use View changes to inspect added, modified, and deleted files, then download a copy or overwrite the original workspace.
    </Step>
  </Steps>

  ### Things to Know

  * Cloud tasks use the files you attach or select during handoff. Add any further local materials the cloud task needs.
  * Each handoff file and the total selected files must be no larger than 500 MB. Wait for the handoff to complete before leaving your computer.
  * Local and cloud project files do not continuously sync. Later local edits are not uploaded automatically, and cloud changes are applied to the original workspace only after you confirm.
  * The original local task remains available. After handoff, the local and cloud tasks keep later conversations and file changes separately.

  ## Sidebar Areas

  * New Task
  * Search
  * Pinned tasks and Agents
  * Project-grouped history
  * Agent Team
  * Scheduled tasks
  * Archived tasks

  ## Common Actions

  | Action | Description |
  | - | - |
  | Rename | Give a task a clearer title. |
  | Pin | Keep important tasks or Agents near the top. |
  | Archive | Hide inactive tasks while keeping them available. |
  | Search | Find previous tasks or run common commands. |
  | Quick navigation | Jump to a target turn in a long conversation to review earlier requirements, execution steps, or results. |
</div>
