@yigstudio/cli

Command-line tool for Yigstudio.

Installation

npm install -g @yigstudio/cli

Or use without installation:

npx @yigstudio/cli [command]

Commands

yigstudio init

Initialize a new Yigstudio project.

yigstudio init

Options:

• -f, --force: Overwrite existing configuration

Creates a yigstudio.config.json file with default MCP servers and skills.

yigstudio run

Run a workflow from a JSON file.

yigstudio run workflow.json

Options:

• -v, --verbose: Verbose output

Workflow Format:

{
  "name": "My Workflow",
  "agentId": "agent-1",
  "tasks": [
    {
      "id": "task-1",
      "type": "skill-invocation",
      "payload": {
        "skillId": "fs-read-file",
        "arguments": {
          "tool": "fs.readFile",
          "params": { "path": "README.md" }
        }
      }
    }
  ]
}

yigstudio skill list

List all registered skills.

yigstudio skill list

yigstudio skill add

Add a new MCP server.

yigstudio skill add <id> [options]

Options:

• -n, --name <name>: Server name
• -c, --command <command>: Server command
• -a, --args <args...>: Server arguments

Example:

yigstudio skill add my-skill \
  --name "My Custom Skill" \
  --command "node" \
  --args "path/to/my-skill.js"

yigstudio skill test

Test connection to MCP servers.

yigstudio skill test

Options:

• -s, --server <id>: Test specific server

Tests all registered MCP servers and reports connection status.

Configuration

The yigstudio.config.json file contains your project configuration:

{
  "workspaceRoot": "/path/to/workspace",
  "mcpServers": [
    {
      "id": "skill-github",
      "name": "GitHub Skill",
      "command": "npx",
      "args": ["@yigstudio/skill-github"],
      "env": {
        "GITHUB_TOKEN": "your-token"
      }
    }
  ],
  "skills": [
    {
      "id": "github-create-issue",
      "name": "Create GitHub Issue",
      "mcpServerId": "skill-github",
      "mcpToolName": "github.createIssue",
      "permissions": ["github:write"]
    }
  ],
  "agents": [
    {
      "id": "agent-1",
      "name": "General Agent",
      "description": "A general-purpose agent"
    }
  ]
}

Example Workflow

1. Initialize project:

   yigstudio init

2. Edit configuration: Edit yigstudio.config.json to add your MCP servers and skills.

3. Test connections:

   yigstudio skill test

4. Create a workflow: Create workflow.json:

   {
     "name": "Read and analyze file",
     "agentId": "agent-1",
     "tasks": [
       {
         "id": "read-file",
         "type": "skill-invocation",
         "payload": {
           "skillId": "fs-read-file",
           "arguments": {
             "tool": "fs.readFile",
             "params": { "path": "data.json" }
           }
         }
       }
     ]
   }

5. Run workflow:

   yigstudio run workflow.json

Environment Variables

• GITHUB_TOKEN: GitHub Personal Access Token (for GitHub skill)
• OPENAI_API_KEY: OpenAI API key (for LLM-powered agents)
• ANTHROPIC_API_KEY: Anthropic API key (for Claude agents)
• SENTINEL_ENDPOINT: Sentinel governance server endpoint (optional)

License

MIT