Run any Skill in Manus with one click

Get Started

rust-backend

Stars5

Forks0

UpdatedMarch 3, 2026 at 23:03

Rust/Tauri v2 backend patterns for agentcockpit native functionality

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

Rixmerz

Rixmerz/agentcockpit

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	rust-backend
description	Rust/Tauri v2 backend patterns for agentcockpit native functionality

Rust Backend (Tauri v2)

Overview

agentcockpit's Rust backend provides native capabilities: PTY management, embedded browser, codebase analysis process management, and shell command execution.

Project Structure

src-tauri/
├── Cargo.toml         # Dependencies and Tauri plugins
├── src/
│   ├── lib.rs         # Main Tauri setup, command registration, DCC process mgmt
│   ├── pty.rs         # PtyManager: spawn, write, resize, close
│   └── browser.rs     # BrowserState: webview create, navigate, show/hide
├── tauri.conf.json    # Tauri config (window, plugins, permissions)
└── capabilities/      # Permission definitions

Common Patterns

Tauri Command Definition

#[tauri::command]
async fn my_command(app: AppHandle, arg: String) -> Result<String, String> {
    // Use parking_lot Mutex for state
    let state = app.state::<Mutex<MyState>>();
    let mut guard = state.lock();
    // ... do work
    Ok(result)
}

State Management

use parking_lot::Mutex;

// Register state in lib.rs
app.manage(Mutex::new(PtyManager::new()));
app.manage(Mutex::new(BrowserState::new()));

// Access in commands
let pty = app.state::<Mutex<PtyManager>>();
let mut pty = pty.lock(); // parking_lot: no .unwrap() needed

Background Threads

// PTY reader thread pattern
std::thread::spawn(move || {
    let mut buf = [0u8; 4096];
    loop {
        match reader.read(&mut buf) {
            Ok(0) => break,
            Ok(n) => {
                let data = String::from_utf8_lossy(&buf[..n]).to_string();
                let _ = app.emit(&format!("pty-output-{}", id), data);
            }
            Err(_) => break,
        }
    }
});

Process Cleanup (Unix)

use libc::{kill, SIGTERM, SIGKILL};

// Graceful shutdown: SIGTERM, wait, SIGKILL
unsafe { kill(-(pid as i32), SIGTERM); }
std::thread::sleep(Duration::from_millis(100));
unsafe { kill(-(pid as i32), SIGKILL); }

Key Dependencies

Crate	Version	Purpose
`tauri`	2.9.5	Desktop framework
`portable-pty`	0.8	Cross-platform PTY
`parking_lot`	0.12	Fast Mutex (no poisoning)
`serde` + `serde_json`	1.0	Serialization
`uuid`	1.x	UUID v4 generation
`tiny_http`	0.12	Debug HTTP server

Best Practices

Use parking_lot::Mutex over std::sync::Mutex — no poisoning, faster
Kill process groups (-pid) not individual processes
Emit events from background threads — don't block Tauri commands
Handle UTF-8 boundaries when reading from PTY
Clean up on Drop — implement proper resource cleanup
Use Result<T, String> for Tauri command return types (serializable errors)

More from this repository

same repository

testing

Rixmerz/agentcockpit

Testing strategy, patterns, and coverage optimization for quality assurance. Use this skill whenever the task involves deciding what to test, how to structure tests, what coverage to aim for, when to use mocks vs real dependencies, or how to write tests that actually catch bugs (not just pass). Also use when the user asks about test pyramids, flaky tests, integration vs unit, TDD, or improving an existing test suite.

2026-04-105

validation

Rixmerz/agentcockpit

Production readiness validation — runs all checks before merging or deploying. Use this skill whenever the task involves verifying that code is ready to ship: type checking, linting, tests passing, coverage thresholds, dead code, security issues, or any pre-merge checklist. Also use when the user asks "is this ready?", wants a pre-PR review, or needs to confirm nothing is broken after a refactor.

2026-04-105

swift-patterns

Rixmerz/agentcockpit

Swift architecture reference — SwiftUI, UIKit, Combine, async/await, actors, and production best practices for Swift 5.9/6.0 (2024-2025). Use when making architectural decisions, reviewing Swift code, or selecting libraries. Also use when the user mentions iOS development, macOS apps, or Apple platform development.

2026-04-035

ui-patterns

Rixmerz/agentcockpit

UI/Frontend architecture reference - React 19, Next.js 15, Vue 3, Svelte 5, Angular 19, CSS modern features, component libraries, state management, and production best practices for 2024-2025. Use when building frontend UIs, selecting frameworks, reviewing component code, or making frontend architecture decisions.

2026-04-035

ux-patterns

Rixmerz/agentcockpit

UX design reference - research methods, design systems, accessibility (WCAG 2.2, EAA), UX laws, AI-driven workflows, tools (Figma, Penpot), and production best practices for 2024-2025. Use when making UX decisions, reviewing designs, implementing accessibility, selecting design tools, or applying UX principles.

2026-04-035

csharp-patterns

Rixmerz/agentcockpit

C# architecture reference - frameworks, design patterns, ASP.NET Core, Entity Framework, Blazor, Unity, and production best practices for C# 12/13 and .NET 8/9 (2024-2025). Use when making architectural decisions, reviewing C# code, or selecting libraries.

2026-03-235

Rust Backend (Tauri v2)

Overview

agentcockpit's Rust backend provides native capabilities: PTY management, embedded browser, codebase analysis process management, and shell command execution.

Project Structure

src-tauri/ ├── Cargo.toml # Dependencies and Tauri plugins ├── src/ │ ├── lib.rs # Main Tauri setup, command registration, DCC process mgmt │ ├── pty.rs # PtyManager: spawn, write, resize, close │ └── browser.rs # BrowserState: webview create, navigate, show/hide ├── tauri.conf.json # Tauri config (window, plugins, permissions) └── capabilities/ # Permission definitions

Common Patterns

Tauri Command Definition

#[tauri::command] async fn my_command(app: AppHandle, arg: String) -> Result<String, String> { // Use parking_lot Mutex for state let state = app.state::<Mutex<MyState>>(); let mut guard = state.lock(); // ... do work Ok(result) }

State Management

use parking_lot::Mutex; // Register state in lib.rs app.manage(Mutex::new(PtyManager::new())); app.manage(Mutex::new(BrowserState::new())); // Access in commands let pty = app.state::<Mutex<PtyManager>>(); let mut pty = pty.lock(); // parking_lot: no .unwrap() needed

Background Threads

// PTY reader thread pattern std::thread::spawn(move || { let mut buf = [0u8; 4096]; loop { match reader.read(&mut buf) { Ok(0) => break, Ok(n) => { let data = String::from_utf8_lossy(&buf[..n]).to_string(); let _ = app.emit(&format!("pty-output-{}", id), data); } Err(_) => break, } } });

Process Cleanup (Unix)

use libc::{kill, SIGTERM, SIGKILL}; // Graceful shutdown: SIGTERM, wait, SIGKILL unsafe { kill(-(pid as i32), SIGTERM); } std::thread::sleep(Duration::from_millis(100)); unsafe { kill(-(pid as i32), SIGKILL); }

Key Dependencies

Crate

Version

Purpose

tauri

2.9.5

Desktop framework

portable-pty

0.8

Cross-platform PTY

parking_lot

0.12

Fast Mutex (no poisoning)

serde + serde_json

1.0

Serialization

uuid

1.x

UUID v4 generation

tiny_http

0.12

Debug HTTP server

Best Practices

Use parking_lot::Mutex over std::sync::Mutex — no poisoning, faster

Kill process groups (-pid) not individual processes

Emit events from background threads — don't block Tauri commands

Handle UTF-8 boundaries when reading from PTY

Clean up on Drop — implement proper resource cleanup

Use Result<T, String> for Tauri command return types (serializable errors)