THORTA OpenCode Plugin & Custom CLI (thorta / opencode+T)

A premium, comprehensive development environment plugin for OpenCode that combines a custom global command wrapper (thorta), multi-framework build automation, static analysis-based knowledge graphing, and spec-driven workflows.

🚀 Custom Global Commands: thorta & opencode+T

We have created global CLI wrapper commands named thorta and opencode+T which run the standard OpenCode AI coding agent but are fully pre-configured with the THORTA ecosystem.

[!NOTE] We recommend using the thorta command instead of opencode+T because the + character is a reserved operator in PowerShell and can cause syntax execution issues on Windows CLIs.

What the global command does when run:

1. Synchronizes Skills: Automatically copies/syncs all 6 custom THORTA skills to the global OpenCode skill paths (~/.config/opencode/skills/ and ~/.opencode/skills/).
2. Rewrites Agent Path Scripts: Generates a dynamic opencode.json configuration, resolving absolute file paths to the globally installed THORTA agent files (so you can run THORTA agents from any folder in your terminal).
3. Spawns OpenCode: Sets the OPENCODE_CONFIG environment variable to load the THORTA setup and spawns the underlying opencode terminal binary, forwarding all arguments interactively.

🛠️ Installation & Global Setup

To use THORTA from any terminal or directory without needing to keep the files locally, or to allow others to install it, use one of the methods below:

Option A: Install Globally from Local Folder (For Developers)

To register the commands on your own machine using your current directory, you must use the absolute path because standard npm does not resolve the Unix tilde (~) correctly on Windows:

# Install using the absolute path to your folder:
npm install -g "C:\Users\AZZEVEDO\OneDrive\THORTA" --force

Option B: Install Globally from Git/GitHub (No files needed locally)

If you push your project to a git repository (like GitHub), anyone can install the commands globally on any machine with a single command, without having the repository files downloaded:

# If public:
npm install -g github:YOUR_GITHUB_USERNAME/THORTA

# If private:
npm install -g git+ssh://[email protected]:YOUR_GITHUB_USERNAME/THORTA.git

Option C: Share as a Bundled Package Tarball

You can generate a redistributable package file (a tarball .tgz containing all code) that you or anyone else can install anywhere without git or local files:

# 1. Inside this folder, build the tarball package:
npm pack

# This creates a file named: thorta-1.0.0.tgz
# 2. You can share this file, and anyone can install it globally using:
npm install -g .\thorta-1.0.0.tgz

🦾 Specialized Agents

THORTA provides three high-performance developer agents in the agents/ folder:

1. 🔨 Build Agent (npm run thorta-build)

• Isolation: Automatically provisions isolated environments inside .kilo/worktrees/build using Git Worktrees (or falls back to a directory copier if Git is not initialized).
• Multi-Framework Build: Detects project configurations (Rust/Cargo, Go, Bun, Yarn, pnpm, npm) and runs the appropriate compiler tool.
• Reporting: Logs total build durations and lists generated build assets alongside their file sizes.

2. 🔍 Research Agent (npm run thorta-research)

• Directory Walking: Scans the project directory (excluding folders like node_modules and .git).
• Static Import Scan: Reads files to parse local import and require(...) statements.
• Knowledge Graph: Generates a comprehensive architectural mapping in .kilo/worktrees/research/knowledge-graph.json containing nodes and edges representing file relations.
• Insights & Recommendations: Identifies code patterns and suggests development steps.

3. 🔗 Integration Agent (npm run thorta-integration)

• Continuous Validation: Checks the codebase for linting (npm run lint), compilation (npx tsc --noEmit if TypeScript is used), and test suites (npm run test).
• Reports: Generates detailed, beautifully formatted reports in both JSON (integration-report.json) and Markdown (integration-report.md) formats inside .kilo/worktrees/integration.

🧠 Integrated Skills

The following 6 skills are installed automatically when using the opencode+T command:

| Skill Name | Purpose | Icon | Description | |---|---|---|---| | graphify | Knowledge Graph | 🧠 | AI codebase import scanning and file mapping. | | awesome-design-md | Design Systems | 🎨 | Premium style guidelines and component layouts. | | agentes | Agent Orchestration | 🤖 | Coordination rules for Build, Research, and Integration agents. | | get-shit-done | Spec-driven workflow | ⚡ | Plan and checklist tracking (task.md rules). | | ui-ux-pro-max | UI/UX Intelligence | ✨ | Sleek styling tokens, CSS structure, and micro-animations. | | ultrathink | Advanced Reasoning | 🧠 | Deep problem deconstruction, planning, and debugging. |

📁 Project Structure

thorta/
├── bin/
│   └── cli.js              # Global wrapper cli binary (opencode+T)
├── agents/
│   ├── build-agent.js      # Isolated compiler runner
│   ├── research-agent.js   # Static codebase scanner
│   └── integration-agent.js # Test & validation runner
├── skills/                 # Custom OpenCode skill directories
│   ├── graphify/
│   ├── awesome-design-md/
│   ├── agentes/
│   ├── get-shit-done/
│   ├── ui-ux-pro-max/
│   └── ultrathink/
├── thorta.json             # THORTA configuration
├── package.json            # npm package configuration
└── README.md               # User documentation

📝 Requirements

• Node.js 18+
• npm (package manager)
• Git (recommended for isolated worktrees)

📄 License

MIT