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

# ⏰ Sessions

# What is a Session?

All Costa usage happens in a **5 hour session window**:

* That window **starts from your first prompt** and **ends exactly 5 hours later**. We call this time window a *session*.

* After a session ends, a new one **automatically starts** the next time you send a prompt.

***

# Why Sessions matter

### Unlock Smarter Insights

Costa analyzes threads from sessions — prompts, context, tool calls, and outcomes — securely and privately, to surface what actually moved the needle. Over time, this data reveals which workflows work, which agents perform best, and how teams build momentum with AI-assisted coding.

<Frame>
  <img src="https://docs-cdn.costa.security/images/session_analytics.png" alt="Codex CLI interface" style={{ borderRadius: '0.5rem' }} />

  <figcaption>Codex running in the command line interface</figcaption>
</Frame>

For more details, see our [<Icon icon="chart-no-axes-combined" /> Insights](/insights) page.

### Ensure Smooth Performance

Have you ever been stuck in a conversation that you knew it was going nowhere?

Coding is like that sometimes too. Some of the most expensive model calls (i.e. high context length) are actually the least valuable. Sessions help us balance usage across providers, models and people.

With our highest tier plans, we find people rarely hit session limits.

### Prevent API Abuse

Our sessions and points are designed to give engineers on our Max plan the feeling of *near unlimited assisted coding*. But Costa is designed for humans that are using AI to make themselves better coders, not for agents running 24/7 without humans in the loop.