Sypha AI Docs
FeaturesTasks

Task Management

Learn how to organize, search, and manage your task history in Sypha.

Sypha offers comprehensive tools for managing your task history, enabling you to organize, locate, and maintain your workspace with greater efficiency. These capabilities become increasingly valuable as your task collection grows over time.

Accessing Task History

Discover multiple convenient methods to open and navigate your task history within Sypha. Whether you prefer using mouse clicks, keyboard combinations, or the command palette, several approaches are available to access your previous work.

Your task history can be accessed through:

  1. Clicking the "History" button located in the Sypha sidebar
  2. Using Command Palette: Look for "Sypha: Show Task History"
  3. Keyboard shortcut (when configured in your VSCode settings)

Task History Interface

Navigate the primary interface displaying and managing all your tasks. This section describes the layout, search functionality, sorting capabilities, and filtering mechanisms that enable efficient navigation through your accumulated work. The task history view offers a comprehensive dashboard for overseeing both past and present tasks.

Search and Filter

The history view provides robust search and filtering features:

  • Fuzzy search spanning all task content
  • Searches across prompts, responses, and code segments
  • Filters results dynamically as you type
  • Highlights matched text within results

Sort Options

Organize your tasks by:

  • Newest (default) - Latest tasks appear first
  • Oldest - Initial tasks appear first
  • Most Expensive - Tasks with highest API costs
  • Most Tokens - Tasks consuming most tokens
  • Most Relevant - Optimal matches during searches

Favorites Filter

  • Toggle visibility to display only starred tasks
  • Rapidly access your most critical work
  • Pair with search for targeted filtering

Task Actions

Learn about the different operations available for individual tasks within your history. From reopening and continuing tasks to exporting and organizing them, this section covers all available task manipulation options.

Each task within the history offers multiple actions:

Primary Actions

  • Open: Click any task to reopen it within the Sypha chat
  • Resume: Continue an interrupted task from its stopping point
  • Export: Convert the conversation to markdown for documentation purposes

Management Actions

  • Favorite ⭐: Click the star icon to designate important tasks
  • Delete 🗑️: Remove specific tasks (favorites receive protection)
  • Duplicate: Generate a new task based on an existing one

⭐ Task Favorites

Learn the favorites system for marking and safeguarding your most important tasks. This capability enables you to star significant work, protecting against accidental removal while offering rapid access to reference implementations and proven patterns.

The favorites system enables preservation and quick retrieval of important tasks.

Using Favorites

Marking Favorites

  • Click the star icon beside any task
  • Star becomes filled when favorited
  • Click once more to remove favorite status

Protection Features

  • Favorited tasks receive protection from accidental deletion
  • Bulk deletion operations exclude favorites automatically
  • Protection can be bypassed with explicit confirmation

Use Cases for Favorites

  • Reference implementations worth preserving
  • Proven problem-solving approaches
  • Tasks containing reusable code snippets
  • Significant project milestones
  • Educational examples for team members

Task Metrics

Access insights into your Sypha usage via task metrics. This section describes how to monitor token consumption, API expenditures, and other metrics to optimize your workflow and manage resources efficiently.

Comprehending your task metrics aids in usage optimization:

Available Metrics

  • Token Usage: Combined input/output tokens utilized
  • API Cost: Cost estimation based on model pricing
  • Checkpoint Count: Total file snapshots created

Using Metrics

  • Budget Tracking: Track API expenditures across tasks
  • Efficiency Analysis: Pinpoint expensive operations
  • Model Comparison: Evaluate costs between different models
  • Optimization: Locate tasks with potential for greater efficiency

On this page