# Testing Mastracode Tui

Testing mastracode TUI features interactively in Konsole.

- Repository: https://github.com/mastra-ai/mastra (29259 stars)
- Category: Testing
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add mastra-ai/mastra --skill testing-mastracode-tui -g -a claude-code -y`
Codex: `npx skills add mastra-ai/mastra --skill testing-mastracode-tui -g -a codex -y`
Cursor: `npx skills add mastra-ai/mastra --skill testing-mastracode-tui -g -a cursor -y`
Gemini CLI: `npx skills add mastra-ai/mastra --skill testing-mastracode-tui -g -a gemini-cli -y`

## Description

Testing mastracode TUI features interactively in Konsole. Covers model configuration, thread lifecycle, task state isolation, and common blockers.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Testing Mastracode TUI

Guide for interactive testing of mastracode's terminal UI in Konsole.

## Devin Secrets Needed

- `OPENROUTER_API_KEY`, for using OpenRouter as a custom provider when Anthropic/OpenAI keys are unavailable

## Prerequisites

1. Build mastracode and its dependencies:

   ```bash
   cd /home/ubuntu/repos/mastra
   COREPACK_ENABLE_STRICT=0 pnpm build:mastracode
   ```

   This may take a few minutes. If `pnpm` has corepack issues, install directly: `npm install -g pnpm@10.11.0`

2. If the build fails due to pre-existing DTS errors in `@mastra/core` or `@mastra/memory`, use `--continue` to let downstream packages (including mastracode) still build:

   ```bash
   COREPACK_ENABLE_STRICT=0 pnpm turbo build --filter ./mastracode --continue
   ```

3. If unit tests fail with missing `@mastra/core/workspace`, run `pnpm build:core` first.

## Configuring a Custom Provider (OpenRouter)

If you don't have a direct Anthropic/OpenAI API key, configure OpenRouter as a custom provider:

1. Edit `~/.local/share/mastracode/settings.json`:

   ```json
   {
     "customProviders": [
       {
         "name": "OpenRouter",
         "url": "https://openrouter.ai/api/v1",
         "apiKey": "<OPENROUTER_API_KEY value>",
         "models": ["minimax/minimax-m2.7"]
       }
     ],
     "models": {
       "activeModelPackId": "custom:Custom",
       "modeDefaults": {
         "build": "openrouter/minimax/minimax-m2.7",
         "plan": "openrouter/minimax/minimax-m2.7",
         "fast": "openrouter/minimax/minimax-m2.7"
       }
     },
     "customModelPacks": [
       {
         "name": "Custom",
         "models": {
           "build": "openrouter/minimax/minimax-m2.7",
           "plan": "openrouter/minimax/minimax-m2.7",
           "fast": "openrouter/minimax/minimax-m2.7"
         },
         "createdAt": "2026-01-01T00:00:00.000Z"
       }
     ]
   }
   ```

The rest: https://github.com/mastra-ai/mastra/blob/HEAD/.claude/skills/testing-mastracode-tui/SKILL.md