Getting Started

Sinaris is a local-first CLI tool that coordinates AI coding agents around confirmed plans, task ownership, and delivery evidence.

Compatibility notice: Sinaris is currently verified with Cursor Agent. Copilot and other AI coding agents are planned for future integrations.

Install

Sinaris is distributed as a .NET global tool. You do not need .NET knowledge or a C# project; the .NET SDK only provides the dotnet command used to install and update Sinaris.

Install the .NET 10 SDK first:

# macOS with Homebrew
brew install --cask dotnet-sdk

# Verify the SDK is available
dotnet --version

# Windows with winget
winget install Microsoft.DotNet.SDK.10

# Restart the terminal, then verify the SDK is available
dotnet --version

# Linux or non-admin install
curl -sSL https://dot.net/v1/dotnet-install.sh -o dotnet-install.sh
bash dotnet-install.sh --channel 10.0
export PATH="$HOME/.dotnet:$HOME/.dotnet/tools:$PATH"

# Verify the SDK is available
dotnet --version

Then install Sinaris for the first time:

dotnet tool install --global Sinaris.Cli

If Sinaris is already installed, update it instead:

dotnet tool update --global Sinaris.Cli

Verify the CLI is ready:

sinaris --version

Initialize A Workspace

Run this from your project root. The first run should be in an interactive terminal because Sinaris asks which agent platform to configure.

# Go to your project root
cd /path/to/your-project

# Initialize Sinaris assets and workspace state
sinaris init

The first run asks for one target platform:

Choice	Platform
1	Copilot
2	Cursor

Later runs reuse the saved choice automatically.

If the sinaris command is not found after installation, restart your terminal. For script-based Linux installs, make sure $HOME/.dotnet/tools is in PATH.

Choose The Right Entry Point

Sinaris has two explicit starting paths and one shared execution path.

Project state	Start with	Purpose
New project or unclear direction	/sx-guide	Confirm the project goal and milestone roadmap.
Existing project has a concrete new requirement	/sx-proposal	Shape the demand, impact, options, and recommendation.
Direction is already confirmed	/sx-design	Turn goals or requirements into executable phase plans.
Work is ready to implement	/sx-apply	Let the agent execute planned tasks with evidence.

Open The Hub

Use the Hub when you need to inspect project state.

sinaris hub

The Hub shows plans, ready work, blocked decisions, agent sessions, activity, and evaluator status in one place.

Resume An Agent Session

When context is interrupted, resume a recorded session instead of restating the project background.

sinaris agent resume --session <id>

Sinaris assembles the latest project context and uses the platform-native resume adapter for the recorded session.

Update Sinaris

Use the same .NET tool command to keep the CLI current.

dotnet tool update --global Sinaris.Cli
sinaris --version

Learn More

• Agent-native Philosophy
• Guide to Evaluator Workflow
• Product Architecture
• CLI Protocol Reference