Workspace

Multi-tool CLI suite with AI-assisted development capabilities, real-time project dashboard, and entity-driven management system. All tools accessible through a single ws binary.

Current Version: 0.52.111061
Build Status: Clean compilation with enterprise logging
Test Status: 89.0% test coverage with 301/302 features implemented

Core Capabilities

Multi-Tool Foundation

Four specialized tools unified under single binary:

Refac: Recursive string replacement with collision detection

ws refactor ./src "OldClassName" "NewClassName" --verbose
ws refactor ./src "OldApi" "NewApi" --backup --include "*.rs"

Scrap/Unscrap: Local trash system with metadata tracking

ws scrap experimental_feature/ temp_logs/ *.bak
ws scrap list --sort date
ws unscrap important.rs

St8: Git-based semantic versioning with template integration

ws git install
ws update --git-add

Ldiff: Line difference visualization for pattern analysis

tail -f /var/log/system.log | ws ldiff

AI-Assisted Development Environment

MCP Server Integration: API endpoints for Claude AI assistance

ws mcp-server  # Start on localhost:3000

Entity-Driven Management: 10 core entity types with relationship tracking

Projects, Features, Tasks, Sessions, Directives
Notes, Templates, Tests, Dependencies, Milestones

Real-Time Dashboard: Professional ADE interface with 9 functional sections

Overview, Sessions, Issues, Features, Workspace
Testing, Entities, Analytics, Settings

Database-Driven Project Management

SQLite Backend: Entity management with relationship tracking

ws status --include-features
ws feature add "New capability"
ws task add "Implement feature" --feature F00001

Template System: Tera-based file generation with version integration

ws template add version-header --template "v" --output version.h

Structured Logging: Enterprise-grade logging with rotation and archiving

Feature Status

Current Implementation: 301/302 features complete (99.7%) Test Coverage: 89.0% with passing validation Architecture: Entity-based with database persistence

Entity Types:

189 Backend Features: Core tools, database system, API layer
115 ADE Interface Features: Dashboard, visualization, user interaction

Quality Assurance:

Zero compilation warnings maintained
Structured logging with file rotation
Safety-first operations with collision detection

Installation

git clone https://github.com/jowharshamshiri/workspace.git
cd workspace
./install.sh

Verification:

ws --version  # Current: 0.52.111061
ws status     # Check installation

Usage Examples

Multi-Tool Operations

# File refactoring with safety checks
ws refactor ./src "old_name" "new_name" --backup

# Safe file disposal and recovery  
ws scrap temp_files/ experimental/
ws unscrap important_config.toml

# Version management with git integration
ws git install
ws update --git-add

Project Management

# Entity management
ws feature add "User authentication"
ws task add "Implement login" --feature F00001
ws status --include-features

# Dashboard access
ws mcp-server  # Start on http://localhost:3000

Development Workflow

# Template-based file generation
ws template add version --template "v" --output version.h

# Real-time log analysis
tail -f app.log | ws ldiff

# Structured project tracking
ws feature list --state implemented
ws task complete T000001 --evidence "Tests passing"

Documentation

Guides:

Installation Guide - Setup instructions
Getting Started - Basic usage
Usage Guide - Common workflows
API Reference - Command reference

Tool-Specific:

Refac Guide - File refactoring
Scrap Guide - File management
St8 Guide - Version management
Ldiff Guide - Log analysis