Команды flowlink-relay

1# Быстрая проверка установки
2flowlink-relay version
3
4# Справка по всем командам
5flowlink-relay --help

1flowlink-agent start [OPTIONS]
2
3# Ключевые флаги
4  --id <agent_id>       ID агента (если не задан — из конфига)
5  --relay-url <url>     URL релея (default: wss://relay.flow-masters.ru:9081)
6  --token <token>       Токен авторизации
7  --foreground          Не уходить в background
8
9# Пример
10$ flowlink-agent start --id ag_abc123 --foreground
11[INFO] Connecting to wss://relay.flow-masters.ru:9081...
12[INFO] Agent ag_abc123 (my-server) connected successfully
13[INFO] MCP endpoint: stdio ready — 27 tools available

1flowlink-agent stop [OPTIONS]
2
3  --id <agent_id>       ID агента (default: активный)
4  --force               Принудительная остановка
5
6$ flowlink-agent stop --id ag_abc123
7[INFO] Sending shutdown signal to ag_abc123...
8[OK] Agent stopped gracefully.

1flowlink-agent status [OPTIONS]
2
3  --id <agent_id>       ID агента
4  --json                Вывод в JSON
5
6$ flowlink-agent status --id ag_abc123
7Agent:          my-server (ag_abc123)
8Status:         connected
9Version:        v0.5.0
10Uptime:         3d 14h 22m
11Commands:       1,247 processed, 3 blocked
12Shield:         active (7 levels)
13MCP tools:      12 available

1flowlink-agent register [OPTIONS]
2
3  --name <name>         Имя агента (обязательно)
4  --tag <tag>           Теги (можно несколько: --tag prod --tag db)
5  --env <env>           Окружение: production|staging|dev
6
7$ flowlink-agent register --name my-server --tag production --env production
8Agent registered successfully!
9  Agent ID: ag_abc123xyz
10  Token:    flk_ag_xyz789... (save this token!)

1flowlink-agent list [OPTIONS]
2
3  --tag <tag>           Фильтр по тегу
4  --status <status>     connected | disconnected
5  --limit <n>           Максимум записей (default: 50)
6
7$ flowlink-agent list --tag production
8ID              NAME         STATUS      TAGS              LAST SEEN
9ag_abc123xyz    my-server    connected   production        2s ago
10ag_def456uvw    db-server    connected   production,db     5s ago
11ag_ghi789rst    web-01       disconnected staging           3h ago

1flowlink-relay policy list [OPTIONS]
2
3  --tag <tag>           Фильтр по тегу агента
4  --format table|json   Формат вывода
5
6$ flowlink-relay policy list
7ID              NAME                TAGS         RULES
8pol_xyz789      Production Policy   production   12
9pol_abc123      Staging Policy      staging      8
10pol_def456      Default Allow       *            3

1flowlink-relay policy create [OPTIONS]
2
3  --name <name>         Имя политики (обязательно)
4  --description <desc>  Описание
5  --tag <tag>           Привязать к тегу агента
6  --file <path>         Файл с правилами (JSON/YAML)
7
8$ flowlink-relay policy create --name "Production Policy" --tag production --file rules.json
9Policy created successfully!
10  Policy ID: pol_xyz789
11  Rules:     12 loaded

1flowlink-relay policy update <policy_id> [OPTIONS]
2
3  --name <name>         Новое имя
4  --description <desc>  Новое описание
5  --file <path>         Обновить правила из файла
6  --append              Добавить правила вместо замены
7
8$ flowlink-relay policy update pol_xyz789 --file rules-v2.json
9Policy pol_xyz789 updated. Rules: 12 → 18

1flowlink-relay policy delete <policy_id> [OPTIONS]
2
3  --confirm             Пропустить интерактивное подтверждение
4
5$ flowlink-relay policy delete pol_abc123
6⚠️  Delete policy "Staging Policy" (pol_abc123)? [y/N]: y
7Policy deleted.

1flowlink-relay policy test [OPTIONS]
2
3  --policy <id>         ID политики (обязательно)
4  --command <cmd>       Команда для проверки (обязательно)
5  --agent <id>          Контекст агента
6
7$ flowlink-relay policy test --policy pol_xyz789 --command "rm -rf /var/log"
8Shield Scan Results:
9┌─────────┬───────────┬──────────────────────────────────┐
10│ Level   │ Decision  │ Reason                           │
11├─────────┼───────────┼──────────────────────────────────┤
12│ L4      │ BLOCKED   │ Destructive command detected     │
13│ L7      │ BLOCKED   │ No production policy exemption   │
14└─────────┴───────────┴──────────────────────────────────┘
15Final: BLOCKED

1flowlink-relay audit log [OPTIONS]
2
3  --agent <id>          Фильтр по агенту
4  --status <s>          success | blocked | error
5  --limit <n>           Число записей (default: 20)
6  --follow              Лив-режим (tail -f)
7
8$ flowlink-relay audit log --limit 5
9TIME                  AGENT       COMMAND                  STATUS      LEVEL
102026-05-15 10:23:01   my-server   ls -la /var/www          allowed     L1
112026-05-15 10:23:05   my-server   cat /etc/passwd          allowed     L2
122026-05-15 10:23:12   my-server   rm -rf /tmp/cache        blocked     L4
132026-05-15 10:23:18   db-server   pg_dump prod_db          allowed     L2
142026-05-15 10:23:25   my-server   curl http://evil.com      blocked     L6

1flowlink-relay audit search [OPTIONS]
2
3  --query <q>           Поисковый запрос (команда, агент, ID)
4  --from <date>         Начало периода (ISO 8601)
5  --to <date>           Конец периода (ISO 8601)
6  --agent <id>          Фильтр по агенту
7  --risk <min>          Минимальный risk score
8
9$ flowlink-relay audit search --query "rm" --from 2026-05-01 --risk 4
102 results found:
11  [1] 2026-05-10 08:15 rm -rf /tmp — BLOCKED (L4, risk 6)
12  [2] 2026-05-12 14:33 rm /var/log/app.log — BLOCKED (L4, risk 5)

1flowlink-relay audit export [OPTIONS]
2
3  --format json|csv     Формат экспорта (default: json)
4  --output <path>       Путь к файлу (default: stdout)
5  --from <date>         Начало периода
6  --to <date>           Конец периода
7  --agent <id>          Фильтр по агенту
8
9$ flowlink-relay audit export --format csv --output audit-may.csv --from 2026-05-01
10Exported 3,412 records to audit-may.csv

1flowlink-relay mcp serve [OPTIONS]
2
3  --stdio               Режим stdio (для Claude Code, Cursor и т.д.)
4  --port <port>         HTTP MCP порт (default: 9082)
5  --agent <id>          ID агента (для привязки инструментов)
6
7# Локальный режим (для Claude Code / Cursor)
8$ flowlink-relay mcp serve --stdio
9[INFO] MCP server started (stdio)
10[INFO] 27 tools registered, Shield active
11
12# HTTP режим (для удалённых агентов)
13$ flowlink-relay mcp serve --port 9082
14[INFO] MCP server started on :9082
15[INFO] Endpoint: https://your-server:9082/mcp

1flowlink-relay mcp status
2
3$ flowlink-relay mcp status
4MCP Server:    running (pid 4281)
5Transport:     stdio
6Tools:         12 available
7Shield:        active (7 levels)
8Uptime:        3d 14h 22m

1flowlink-relay mcp tools [OPTIONS]
2
3  --json                Вывод в JSON
4
5$ flowlink-relay mcp tools
6  flowlink_exec        Execute command on agent
7  flowlink_shell       Open interactive shell
8  flowlink_files_read  Read file content
9  flowlink_files_write Write file content
10  flowlink_files_list  List directory
11  flowlink_docker_ps   List Docker containers
12  flowlink_docker_logs Get container logs
13  flowlink_system_info System information
14  flowlink_audit_log   Query audit log
15  flowlink_policy_test Test command against policy
16  flowlink_git_status  Git repository status
17  flowlink_git_diff    Git diff output

1flowlink-relay shield status [OPTIONS]
2
3  --agent <id>          ID агента
4  --json                JSON вывод
5
6$ flowlink-relay shield status
7Shield:         ACTIVE
8Levels:         7/7 enabled
9  L1  Input validation         ✓
10  L2  Pattern detection         ✓
11  L3  Risk scoring              ✓
12  L4  Destructive command check ✓
13  L5  Injection detection        ✓
14  L6  Network restriction        ✓
15  L7  Policy enforcement         ✓
16Blocked today: 47
17Allowed today: 1,247

1flowlink-relay shield config [OPTIONS]
2
3  --show                Показать текущую конфигурацию
4  --set <key=val>       Установить параметр
5  --reset               Сбросить к defaults
6
7$ flowlink-relay shield config --show
8{
9  "levels": [1, 2, 3, 4, 5, 6, 7],
10  "risk_threshold": 5,
11  "block_on_unknown": true,
12  "network_allowlist": ["10.0.0.0/8", "172.16.0.0/12"],
13  "destructive_commands": ["rm -rf", "mkfs", "dd if=", "DROP TABLE"]
14}

1flowlink-relay shield rules [OPTIONS]
2
3  --list                Показать все правила
4  --add <rule>          Добавить правило (JSON)
5  --remove <id>         Удалить правило по ID
6
7$ flowlink-relay shield rules --list
8ID     LEVEL  ACTION    PATTERN
9r001   L4     BLOCK     rm -rf /
10r002   L4     BLOCK     mkfs.*
11r003   L4     BLOCK     dd if=.*
12r004   L5     BLOCK     curl.*\|.*sh
13r005   L5     BLOCK     wget.*\|.*bash
14r006   L6     ALLOW     10.0.0.0/8
15r007   L6     DENY      0.0.0.0/0

1flowlink-relay config show [OPTIONS]
2
3  --path <path>         Путь к конфигу (default: /opt/flowlink/etc/relay.json)
4  --json                JSON вывод
5
6$ flowlink-relay config show
7Config file: /opt/flowlink/etc/relay.json
8  Agent ID:     ag_abc123xyz
9  Relay URL:    wss://relay.flow-masters.ru:9081
10  MCP port:     9082
11  Shield:       enabled
12  Environment:  production

1flowlink-relay config set <key> <value> [OPTIONS]
2
3  --path <path>         Путь к конфигу
4
5$ flowlink-relay config set relay.url wss://custom.relay.example.com:9081
6✓ relay.url updated
7
8$ flowlink-relay config set shield.risk_threshold 7
9✓ shield.risk_threshold updated

1flowlink-relay config init [OPTIONS]
2
3  --path <path>         Путь к конфигу (default: /opt/flowlink/etc/relay.json)
4  --force               Перезаписать существующий файл
5
6$ flowlink-relay config init --path ./relay.json
7✓ Configuration initialized at ./relay.json
8  Edit the file and run: flowlink-agent start

1flowlink-relay version [OPTIONS]
2
3  --json                JSON вывод
4  --check               Проверить наличие обновлений
5
6$ flowlink-relay version
7flowlink-relay v0.7.0
8Build:    2026-05-10
9Commit:   a1b2c3d
10Go:       1.22.4
11OS/Arch:  linux/amd64
12Relay:    compatible (v3+)
13
14$ flowlink-relay version --check
15Current:  v0.5.0
16Latest:   v0.5.1
17Update available! Run: curl -fsSL https://get.flowlink.sh | bash

1# Пример использования в скриптах
2flowlink-agent start --id ag_abc123
3if [ $? -eq 2 ]; then
4  echo "⚠️  Команда заблокирована политикой Shield"
5  exit 2
6fi

1# Добавить в ~/.bashrc или ~/.bash_profile
2flowlink-relay completion bash > /etc/bash_completion.d/flowlink
3source /etc/bash_completion.d/flowlink

1# Добавить в ~/.zshrc
2flowlink-relay completion zsh > "${fpath[1]}/_flowlink"
3compinit

1flowlink-relay completion fish > ~/.config/fish/completions/flowlink.fish