TARS - Tooling, Agents, Roles, Skills

<img src="apps/tars-desktop/src-tauri/icons/tars-base.png" alt="TARS Logo" width="128" height="128"> A cross-platform desktop application for managing Claude Code configuration across projects <a href="https://github.com/inceptyon-labs/TARS/releases/latest"><img src="https://img.shields.io/github/v/release/inceptyon-labs/TARS?style=flat-square" alt="Release"></a> <a href="https://github.com/inceptyon-labs/TARS/actions"><img src="https://img.shields.io/github/actions/workflow/status/inceptyon-labs/TARS/release-linux-windows.yml?style=flat-square" alt="Build"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License"></a> <img src="https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey?style=flat-square" alt="Platform"> <a href="https://github.com/inceptyon-labs/TARS/releases"><img src="https://img.shields.io/github/downloads/inceptyon-labs/TARS/total?style=flat-square" alt="Downloads"></a> <a href="#features">Features</a> • <a href="#installation">Installation</a> • <a href="#usage">Usage</a> • <a href="#architecture">Architecture</a> • <a href="#development">Development</a>

Overview

TARS is a centralized hub for discovering, creating, editing, and managing Claude Code resources. It provides a visual interface for managing skills, agents, commands, hooks, MCP servers, and plugins across multiple projects with safe apply/rollback operations and profile-based configuration sharing via a local profile marketplace.

Inspired by the robot from Interstellar, TARS brings order to your Claude Code configuration chaos.

Features

Project Management

Multi-project tracking - Add and manage multiple projects from a single interface
Configuration scanning - Automatically discover skills, commands, agents, hooks, and MCP servers
Collision detection - Identify configuration conflicts across scopes
Context stats - View token and character usage for project context
Project stats - Code metrics including:
- Language breakdown with visual bar chart
- Lines of code, files, and comment ratios
- TODO/FIXME marker counts (detects TODO:, TODO(, TODO- patterns in comments)
- Test coverage from lcov.info or tarpaulin reports
- Dependency counts from package.json, Cargo.toml, pyproject.toml
Project notes - Personal markdown notes per project (gitignored NOTES.md)
- Collapsible panel with line count preview when closed
- Rich markdown editor with code block support
- Keyboard shortcuts for save (Cmd/Ctrl+S)

Skills Management

Browse & search - Filter skills by scope (User, Project, Plugin, Managed)
Create & edit - Full markdown editor with YAML frontmatter support
Real-time YAML validation - Inline error highlighting for frontmatter syntax issues
Supporting files - View and manage progressive disclosure files (reference.md, examples.md, scripts/) alongside skills
Scope management - Move skills between user and project scopes
Syntax highlighting - Code blocks with language-specific highlighting

Agents Management

Agent definitions - Create and edit agent configurations
Enable/disable - Toggle agents on/off without deleting
Scope control - Move agents between configuration scopes
Markdown editing - Rich editor for agent prompts and instructions
Real-time YAML validation - Inline error highlighting for frontmatter syntax issues

Commands Management

Slash commands - Create custom /command-name definitions
Template support - Use $ARGUMENTS placeholder for dynamic input
Scope hierarchy - Manage commands at user or project level
Real-time YAML validation - Inline error highlighting for frontmatter syntax issues

Hooks Configuration

Event-driven hooks - Configure actions for Claude Code events
Event types supported:
- PreToolUse / PostToolUse - Before/after tool execution
- Stop - When Claude stops
- SessionStart / SessionEnd - Session lifecycle
- UserPromptSubmit - User input handling
- PreCompact - Before context compaction
- Notification - System notifications
- SubagentStop - Subagent completion
Hook types - Command execution or prompt injection
Matcher patterns - Filter which tools/events trigger hooks

MCP Servers

Server management - Add, remove, and configure MCP servers
Transport types - Support for stdio, HTTP, and SSE
Scope configuration - User, project, and profile scopes
Environment variables - Configure server environment
Plugin integration - View MCP servers provided by installed plugins

Plugin Management

Marketplace support - Add GitHub, URL, or local marketplace sources
Install/uninstall - Manage plugin lifecycle
Scope control - Install at user, project, or local scope
Enable/disable - Toggle plugins without uninstalling
Auto-update - Configure automatic marketplace updates
Cache management - View and clean plugin cache

Profiles

Profiles let you create reusable configuration bundles that can be shared across multiple projects. Think of them as "presets" for your Claude Code setup that install as native Claude Code plugins through a local marketplace.

How It Works

Profiles are plugin drafts that bundle MCP servers, skills, agents, commands, and hooks
TARS generates a Claude Code plugin in ~/.tars/profiles/<id>/plugin/
The plugin is synced into a local marketplace at ~/.claude/plugins/marketplaces/tars-profiles/
When applied, TARS installs tars-profile-<slug>@tars-profiles via the Claude CLI
This provides native plugin management: scope control, enable/disable, clean uninstall
Tools can be pinned (frozen at current version) or tracked (detect source changes)

Creation Wizard

Guided setup - Step-by-step wizard for creating profiles
Multiple source options:
- Single project - Import tools from one specific project
- Registered projects - Pick tools from projects already added to TARS
Development folder - Scan an entire folder for all Claude-configured projects
Start empty - Create a blank profile and add tools later
Tool discovery - Automatically finds MCP servers, skills, agents, commands, and hooks from project .claude/ directories and .mcp.json files

Tool Management

Visual tool picker - Browse and select tools with descriptions and source info
Categorized view - Filter by MCP servers, skills, agents, commands, or hooks
Bulk selection - Select all or clear selections quickly
Search - Find specific tools across all discovered projects
Profile scope authoring - Create tools directly inside a profile from the module editors
Source modes:
- Pin - Freeze tool at current version, ignore source changes
- Track - Detect when source files change, offer updates

Update Detection

Change detection - Automatically detect when tracked tool sources change
Update indicators - Visual badges show which tools have updates available
Pull updates - One-click update to sync from source and regenerate plugin
Selective updates - Update individual tools without affecting others

Profile Application

Apply to Project - Install as project-scoped plugin from tars-profiles
Apply to User - Install as user-scoped plugin from tars-profiles
Marketplace sync - Local marketplace and manifest are regenerated on profile changes
Native uninstall - Remove via claude plugin uninstall
Auto-regeneration - Plugin automatically regenerates when profile changes

Import/Export

Plugin export - Export profiles as Claude Code plugin .zip files
Legacy import - Import .tars-profile.json profiles from teammates or community
Collision handling - Detect and resolve name conflicts on import

Safety Features

Atomic updates - Plugin regeneration uses atomic directory replacement
Secure file handling - Path traversal protection, symlink skipping, depth limits
Name sanitization - Tool names validated for filesystem safety

Knowledge Center (CASE)

Documentation - Built-in reference for all Claude Code features
Searchable - Quick access to skills, agents, commands, hooks, MCP, and plugin docs
External links - Direct links to official documentation

Prompts Library

Personal storage - Save prompts and notes (not loaded by Claude)
Rich editing - MDXEditor with full markdown support
Code blocks - Syntax highlighting for 14+ languages
Separate storage - Stored in app data directory, independent of Claude config

Beacons

Navigation bookmarks for quick access to project-related resources:

Multiple link types - GitHub repos, documentation, APIs, Reddit, Twitter, custom URLs
Categories - Organize beacons into custom categories
Tags - Add searchable tags for filtering
Multi-link support - Store multiple related URLs per beacon
Quick open - Launch links directly from the app
Separate storage - Stored in ~/.tars/beacons/, independent of Claude config

Updates

Claude Code updates - Compare installed vs latest version with update notifications
Plugin updates - Detect available updates for marketplace plugins with versi

TARS

Install / Use

README