getting-started

Guide developers through installing, configuring, and starting a Trebuchet project.

Updated Jan 27, 2026
One-click install
npx skills add https://github.com/briannadoubt/trebuchet-plugin --skill getting-started-briannadoubt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: getting-started
Source: https://github.com/briannadoubt/trebuchet-plugin/tree/main/skills/getting-started
Command: npx skills add https://github.com/briannadoubt/trebuchet-plugin --skill getting-started-briannadoubt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a clear, quick-start path for teams to set up and begin using Trebuchet distributed actors, reducing onboarding time and avoiding common configuration pitfalls.

Core Features & Use Cases

  • Guided installation: Steps for adding Trebuchet to a Swift project via Package.swift, CocoaPods, or Xcode integration.
  • First actor pattern: Walkthrough to create a simple distributed actor and wire up server-client communication.
  • Hands-on examples: Quick templates and configuration snippets that cover common patterns like server exposure and client resolution for local and remote calls.
  • Use Case: Bootstrap a new project quickly, then scale to streaming and cloud deployment.

Quick Start

Install the Trebuchet CLI or library, initialize a new project, and follow the included examples to create and expose a basic actor.

  • Install the CLI: mint install briannadoubt/Trebuchet or build from source and copy the binary to your PATH.
  • Initialize a project and run: trebuchet dev in your project directory, then trebuchet deploy to publish.
  • Create a simple actor and expose it: define a distributed actor, start the server, and resolve the actor from a client.

Frequently Asked Questions about getting-started

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up distributed actors in a Swift project?

To set up distributed actors in a Swift project, add the Trebuchet library to your Package.swift, define a distributed actor, and wire up server-client communication using the provided quick-start templates.

What is the best way to install Trebuchet for Swift server-client development?

The best way to install Trebuchet for Swift server-client development is using the CLI via `mint install briannadoubt/Trebuchet` or building from source and copying the binary to your PATH.

Do I need external dependencies to configure a Trebuchet distributed actor system?

You do not need external dependencies to configure a Trebuchet distributed actor system beyond Trebuchet itself and standard Swift tooling, keeping the setup process lightweight.

How do I expose a Swift distributed actor to a remote client?

To expose a Swift distributed actor to a remote client, define the actor, start the server using the Trebuchet CLI, and resolve the actor from the client using common server-client patterns.

Can I scale a basic Trebuchet actor setup for cloud deployment?

You can scale a basic Trebuchet actor setup for cloud deployment by bootstrapping a local project first, then advancing to streaming and cloud deployment using the `trebuchet deploy` command.