Documentation

Agent Workspace

Explore the features available in your Kindship agent's workspace including chat, planning, files, and more.

Every Kindship agent has its own workspace — a dedicated space where you collaborate, direct live work, inspect execution, manage replies, and track the agent's rhythm over time. This guide covers the main surfaces you will use most often.

Workspace Overview

When you open an agent, you'll typically move between a focused default view and a fuller multi-panel workspace:

  • Minimal workspace — A calm composer-first view when no deeper context is selected
  • Plan tab — Planning structure and live execution activity in one place
  • Inbox — Pending asks, approvals, and replies from the agent
  • Documents & Files — Related files, documents, and linked execution context
  • Videos — Published videos created by the agent
  • Sites and email status — Public surfaces when the agent manages a website or communication channel
  • Heartbeat — The agent's recurring health and cadence signal
  • Settings — Agent configuration, execution preferences, and credentials

Minimal View vs Expanded Workspace

When you first open an agent, Kindship may show a minimal composer-focused state instead of dropping you directly into a dense multi-panel layout.

  • The minimal view is useful when you just want to send a message or respond to something pending
  • The expanded workspace appears when you open a specific tab, thread, entity, or deeper context
  • Pending inbox items can still surface in the minimal state, so you do not have to expand the full workspace just to answer an agent

Chat And System Chat

Kindship now separates conversational collaboration from operational control.

Standard Chat

Use the main chat when you want to think with the agent, ask questions, review plans, or refine ideas.

System Chat

Use System Chat when you want to direct the agent's active work more explicitly and watch the result show up in the activity stream.

  • Real-time updates make active work easier to follow
  • Optimistic messages make the interface feel more immediate while work starts
  • Stop controls let you interrupt active system-chat work when you need to redirect it

Message History

Conversations and system-chat history are preserved so you can come back to earlier decisions, instructions, and execution context.

Rich Content

Your agent can present information in various formats:

  • Formatted text with headers and lists
  • Tables for comparing options
  • Code blocks for technical content
  • Links to related topics

Context Awareness

A sidebar or panel may show what your agent is currently referencing:

  • Active objectives and projects
  • Relevant past conversations
  • Connected information
  • Related run activity or files

The Plan Tab

The Plan tab is where planning structure and live execution now come together. Instead of splitting planning and activity into two different mental models, Kindship keeps the structure and the motion closer together.

Prime Directive

Your agent's core purpose statement. This guides all its recommendations and decisions, even though it is no longer repeated as heavily across every surface.

Objectives

High-level goals you're working toward. These represent what success looks like.

Projects

Specific initiatives that support your objectives. Each project has a clear scope and outcome.

Tasks

Individual action items. Tasks can be:

  • Pending — Not yet started
  • In Progress — Currently being worked on
  • Completed — Finished
  • Ephemeral — Temporary work that can auto-clean after a successful completion

Viewing Plans

The workspace now emphasizes a more unified view:

  • Plan structure stays visible alongside the work that is currently happening
  • Live activity banners and entity-scoped activity cards help you understand what is moving right now
  • Processes sit alongside projects when you need recurring work instead of one-off delivery

Editing Plans

Make changes directly in the planning interface, or chat with your agent:

  • "Add a new project for customer research"
  • "Mark the website task as complete"
  • "Update the deadline for the launch"

Inbox And Replies

The workspace now treats user messaging as a first-class part of collaboration instead of a side mechanic.

Inbox Tab

The Inbox tab helps you manage questions, approvals, choices, and reports from the current agent.

  • Pending asks are actionable directly from the tab
  • Reports are informational by default, so they should not behave like hidden confirmation prompts
  • Resolved history stays available, so you can revisit what was asked and how it was answered
  • The tab can auto-open when new action is waiting, but it is designed not to keep stealing focus once you have chosen another view

Cross-Agent Inbox

Kindship also has a broader inbox at /home/inbox for triaging asks across multiple agents.

  • Pending badges highlight where action is waiting
  • Filters help you narrow by agent, urgency, or status
  • Deep links can open the right thread inside the right agent, which makes context recovery much easier

Activity, Runs, Files, And Videos

The activity area is no longer just a passive history view. It is where you inspect active runs, recent output, and the trail around completed work.

Live Run Activity

When an agent is actively working, the activity view can stream execution output as it happens.

  • Structured activity blocks make mixed output easier to scan
  • Long histories load progressively so large runs feel more manageable
  • Entity and file links help you move from an execution event into the related context

Planning Changes

See when objectives, projects, processes, or tasks were added, updated, deleted, or completed. This provides an audit trail of how the plan evolved.

Filesystem And Visual Context

The workspace can also surface related files and execution-linked file references so you can inspect what changed without losing your place. Supported image files can be previewed directly in the filesystem viewer, and richer agent outputs such as PDFs, spreadsheets, slide decks, and audio files can open in dedicated viewers when available.

Agent messages and activity logs can link directly to workspace paths. When a dispatch mentions a file, route, or generated artifact, follow the link instead of hunting through the tree manually.

Videos

Some agents can now publish videos directly into their workspace.

  • The Videos tab lists published videos for the current agent
  • Videos open in an in-app player, so review can happen inside the workspace instead of in a separate tool
  • Rendered MP4 previews and downloads can appear from the same video surface when an agent produces a portable version
  • This is especially useful for presentation, storytelling, or media-heavy agents that produce output you want to watch rather than only read

Sites

Some agents maintain public websites. Site work usually starts in the agent's local workspace, then moves through CLI publishing, build logs, and live verification.

  • Site status and logs help distinguish active builds from failed or empty output
  • Site verification checks whether the public URL is actually serving the expected result
  • Custom-domain changes may require another push so metadata, feeds, and sitemaps reflect the current canonical URL

See Agent-Managed Sites for the full workflow.

Agent Email

Agents can also have an email channel when communication is part of their work.

  • Email readiness tells you whether the channel is usable yet
  • Stable agent slugs keep addresses more predictable
  • Communication agency settings decide whether the agent can send silently, report after sending, or ask first

See Agent Email for setup and troubleshooting.

Conversation History

Past conversations remain available when you need to revisit a decision, recover context, or compare earlier instructions with the current state.

Heartbeat

Heartbeat is the recurring signal that tells you whether an agent is still keeping its expected rhythm.

  • Current cadence shows how often the heartbeat is supposed to run
  • Next execution visibility helps you understand what should happen next
  • Status feedback helps you tell the difference between a healthy recurring agent, an active recovery, and one that may need attention

Workspace Settings

Configure your agent and workspace:

Agent Settings

  • Name — What your agent is called
  • Prime Directive — Core purpose (can also edit via chat)
  • Preferences — How your agent communicates
  • Inner Loop — Which coding CLI and model the agent should use for execution

CLI Authentication

If the agent uses coding tools, the workspace can also show provider authentication status.

  • Multiple coding CLIs can be checked from the agent page
  • Status distinguishes reachable, installed, configured, and authorized states
  • The credentials dialog is where you connect or update provider access
  • Agents can be marked as requiring your own provider credentials when you do not want them to fall back to Kindship-managed credentials

Backups

Manual backups are available from agent menus for supported accounts.

  • Recent backup history is visible in a dedicated sheet
  • In-flight backups show live progress
  • Backups are designed to be more than invisible background maintenance

Notification Settings

Control what alerts you receive:

  • Task reminders
  • Goal progress updates
  • Agent suggestions
  • System and agent notifications that need attention

Appearance

Customize how the workspace looks:

  • Layout preferences
  • Theme settings
  • Display options

Working Efficiently

Quick Actions

Common tasks often have shortcuts:

  • Create new task
  • Start new conversation
  • Access recent projects

Keyboard Shortcuts

For power users, keyboard shortcuts speed up common actions. Look for a shortcuts reference in the interface.

Find anything in your workspace:

  • Past conversations
  • Specific tasks or projects
  • Documents, files, and execution context

Collaboration Features

If you're on a team account, additional features become available:

Shared Access

Team members can access the same agent, seeing shared conversations and planning.

Comments

Leave comments on tasks or projects for teammates.

Assignments

Assign tasks to specific team members.

Activity Visibility

See who made what changes and when.

Mobile Access

Your workspace is accessible on mobile devices:

  • Responsive design adapts to screen size
  • Core features work on phones and tablets
  • Some advanced features may be simplified

Data & Privacy

Your workspace data is:

  • Private by default — Only you can access (unless shared with team)
  • Encrypted — Protected in transit and at rest
  • Exportable — You can export your data anytime
  • Deletable — You can delete your agent and all associated data

Troubleshooting

Workspace is loading slowly

Try refreshing the page. If the problem persists, check your internet connection and give long activity histories a moment to hydrate and load progressively.

Can't find a past conversation

Use the search function. Try different keywords or check the date range.

Planning changes aren't saving

Ensure you have a stable internet connection. Changes sync automatically when connected.

I can't tell whether the agent is still running

Check the activity stream and the Heartbeat section together. Activity shows live or recent execution output; Heartbeat shows whether recurring work is still landing on schedule.

If the heartbeat is recovering, treat that differently from a silent failure. A running recovery means the system is already trying to bring the recurring work back onto schedule.

I answered an agent, but I want to see the full context

Open the Inbox tab or the cross-agent inbox and follow the deep link back into the originating thread. Kindship keeps user messaging closer to the thread it came from than it used to.

A report is increasing noise but does not need action

Treat it as informational. Action badges and task lists should focus on asks. See Reports And Asks for how to triage agent messages.

Next Steps