Skip to content

azaek/cntrl

Repository files navigation

Cover

License Release Bridge Ai-assisted

The programmable API for your desktop. Script your workspace with standard HTTP/WebSockets.

Apps

App Description
bridge Tauri desktop agent for Windows/macOS - runs a local API server

Packages

Package Description
@cntrl-pw/sdk TypeScript SDK for interacting with Cntrl Bridge
@cntrl-pw/ui Shared UI components

Development

Prerequisites

Setup

# Install dependencies
pnpm install

# Run all apps in dev mode
pnpm dev

# Run specific apps
pnpm dev:bridge   # Tauri desktop app
pnpm dev:hub      # Dashboard
pnpm dev:docs     # Documentation
pnpm dev:web      # Website

Building

# Build all apps
pnpm build

# Build Bridge desktop app
pnpm build:bridge

Bridge App

The Bridge app is a Tauri 2 desktop application that:

  • Runs a local HTTP/WebSocket agent for programmable control
  • Provides system stats, media control, and power management APIs
  • Supports auto-updates with stable and beta channels

Auto-Update Channels

Updates are delivered through GitHub Releases:

Channel Version Pattern Example
Stable v1.0.0 Regular releases
Beta v1.0.0-beta.1 Pre-release testing

The app automatically selects the update channel based on its version:

  • Stable versions check latest-stable.json
  • Beta versions check latest-beta.json

Releasing

# Release stable version
git tag v1.0.0
git push origin v1.0.0

# Release beta version
git tag v1.0.0-beta.1
git push origin v1.0.0-beta.1

GitHub Actions will automatically build and publish to the appropriate channel.

Tech Stack

License

MIT

About

A lightweight agent that turns your PC into a scriptable IoT device. Monitor stats, control media, and trigger automation from any device on your local network.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors