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

# Little Spaces: see what your coding agents need from you

> Little Spaces shows what your coding agents are doing across apps and computers, and gathers every question they have for you into one inbox.

Your coding agents work in many places at once: several apps, several computers, several projects. Little Spaces is the one place that shows what they are doing and what they need from you. This page explains the idea and the three views you work in.

> [!NOTE]
>
> Little Spaces is in early access. You sign in with GitHub, and access is by invitation.

## How it works

1. **Agents tell it what is happening.** Two kinds of signal arrive:
   * **Hooks** on your computer send small automatic signals for each session: it started, it is working, it is waiting, it ended. They never send your prompts or transcripts.
   * **Reports** come from the agents themselves at milestones, such as "found the bug", "opened a pull request" or "blocked".
2. **Agents ask you things.** When an agent needs a decision, it attaches an ask to a report: a question with options and its recommendation, a request for approval, or a request to review or merge a pull request.
3. **You see it all in one place.** Three views show it:
   * **Inbox:** the home view. Everything waiting on you, most urgent first: agents stopped on you, questions holding up work, then everything else waiting, such as pull requests ready to merge and to-dos.
   * **Map:** every live session, by project and computer, which sessions work for which, and what is moving or has gone quiet.
   * **Activity:** the history of reports, grouped into workstreams, with each project's sessions listed under **Runs**.
4. **You answer wherever you are.**
   * **In Little Spaces:** your answer goes to the session the next time it checks, and some apps' hooks can wake a session that is waiting.
   * **In the agent's own session:** answer a question or approval there, and the agent reports your reply, so the ask closes in Little Spaces too.
5. **GitHub fills in the rest.** Once you link the Little Spaces GitHub App, pull request states (checks, ready, merged) come from GitHub, so an ask to merge a pull request closes by itself once it merges.

## Where to go next

> **[Quickstart](https://docs.littlespaces.dev/quickstart.md)**
>
> Sign in, connect the agents on your computer with one prompt, and answer your first question.

> **[Reports and asks](https://docs.littlespaces.dev/how-it-works/reports-and-asks.md)**
>
> What agents send, the four kinds of ask, and how long an ask stays open.

> **[Hooks or MCP](https://docs.littlespaces.dev/connecting-agents/hooks-vs-mcp.md)**
>
> The two ways to connect an agent, and when to use which.

> **[Supported agents](https://docs.littlespaces.dev/connecting-agents/supported-agents.md)**
>
> The apps setup connects, what works in each, and which can be woken.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.