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

# Changelog

> Product updates and announcements

<Update label="Jan 2026" description="v0.1.0">
  * **New `@cycls.app()` decorator** - Simplified API with all configuration in one place. Replaces `cycls.Agent()` and `@agent()`.
  * **New deployment methods** - Use `app.local()` for development with hot-reload, and `app.deploy()` for cloud deployment.
  * **Native UI components** - Stream rich content with thinking bubbles, code blocks, tables, callouts, images, and status indicators by yielding structured objects.
  * **Cycls Protocol** - New `/chat/cycls` endpoint for streaming native UI components alongside the OpenAI-compatible `/chat/completions` endpoint.
  * **Cycls Pass monetization** - Enable subscription-based access with `plan="cycls_pass"` and gate features based on `context.user.plan`.
  * **Auto .env loading** - Cycls automatically loads `.env` files when using `copy=[".env"]`. No need for `python-dotenv`.
  * **Claude Agent SDK integration** - New guide for building agents with Anthropic Claude and tool support.
</Update>

<Update label="Nov 2025" description="v0.0.2.52">
  * The chat interface has been redesigned for a cleaner look and now supports image attachments.
  * Deprecated `agent.local()` in favor of `agent.deploy(prod=False)`. This creates a full Docker build locally, matching the production environment.
  * Cycls Cloud is now live for serverless agent deployment (`agent.deploy(prod=True)`).
  * You can now set a custom title for your agent using the `title` parameter in the `@agent` decorator.
  * Added `copy_public` parameter to `cycls.Agent()` for easily copying public assets (like logos) to the frontend.
  * Replaced multiple API keys with a single `key` parameter in `cycls.Agent()` for cloud deployment authentication.
</Update>

<Update label="Aug 2025" description="v0.2.45">
  * Cycls is now open-source [GitHub](https://github.com/Cycls/cycls).
  * Use `agent.local()` to serve an agent locally and `agent.deploy()` to deploy it to the Cycls cloud.
  * Use `@agent()` decorator to define agent configuration, including `pip`/`apt` dependencies and authentication rules, directly within a Python script.
  * All deployed agents now automatically serve a streaming, OpenAI-compatible `/chat/completions` API endpoint.
  * Auto generated, customizable web chat UI for every agent.
  * Built-in user and context management to enable the creation of stateful, multi-turn agents.
</Update>