@quiel/cli 0.4.1 → 0.4.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli.js +2 -3
- package/package.json +2 -3
- package/README.ru.md +0 -137
package/dist/cli.js
CHANGED
|
@@ -4670,7 +4670,7 @@ ${question.answerMd ?? ""}`;
|
|
|
4670
4670
|
// package.json
|
|
4671
4671
|
var package_default = {
|
|
4672
4672
|
name: "@quiel/cli",
|
|
4673
|
-
version: "0.4.
|
|
4673
|
+
version: "0.4.2",
|
|
4674
4674
|
description: "CLI \u0438 MCP-\u0441\u0435\u0440\u0432\u0435\u0440 Quiel: \u043F\u043E\u0434\u043A\u043B\u044E\u0447\u0430\u0435\u0442 \u0430\u0433\u0435\u043D\u0442\u0430 \u0443\u0447\u0430\u0441\u0442\u043D\u0438\u043A\u0430 (Claude Code, Codex, Cursor, OpenCode) \u043A \u043F\u043B\u0430\u0442\u0444\u043E\u0440\u043C\u0435",
|
|
4675
4675
|
homepage: "https://quiel.ai",
|
|
4676
4676
|
repository: {
|
|
@@ -4698,8 +4698,7 @@ var package_default = {
|
|
|
4698
4698
|
},
|
|
4699
4699
|
files: [
|
|
4700
4700
|
"dist",
|
|
4701
|
-
"README.md"
|
|
4702
|
-
"README.ru.md"
|
|
4701
|
+
"README.md"
|
|
4703
4702
|
],
|
|
4704
4703
|
engines: {
|
|
4705
4704
|
node: ">=22"
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@quiel/cli",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.2",
|
|
4
4
|
"description": "CLI и MCP-сервер Quiel: подключает агента участника (Claude Code, Codex, Cursor, OpenCode) к платформе",
|
|
5
5
|
"homepage": "https://quiel.ai",
|
|
6
6
|
"repository": {
|
|
@@ -28,8 +28,7 @@
|
|
|
28
28
|
},
|
|
29
29
|
"files": [
|
|
30
30
|
"dist",
|
|
31
|
-
"README.md"
|
|
32
|
-
"README.ru.md"
|
|
31
|
+
"README.md"
|
|
33
32
|
],
|
|
34
33
|
"engines": {
|
|
35
34
|
"node": ">=22"
|
package/README.ru.md
DELETED
|
@@ -1,137 +0,0 @@
|
|
|
1
|
-
# @quiel/cli
|
|
2
|
-
|
|
3
|
-
**English version — [README.md](https://github.com/Quiel-AI/quiel-cli/blob/main/README.md).**
|
|
4
|
-
|
|
5
|
-
[](https://www.npmjs.com/package/@quiel/cli)
|
|
6
|
-
|
|
7
|
-
Клиент Quiel: одновременно CLI **и** MCP-сервер, который подключает вашу агентскую программу — Claude Code, Codex, Cursor или OpenCode — к проекту на платформе [Quiel](https://quiel.ai).
|
|
8
|
-
|
|
9
|
-
Quiel — это продукт, который оркеструет команду и агентов её участников: задачи хранятся в едином графе, каждый подключает своего агента, и в автономном режиме агент сам забирает задачи своей роли, выполняет их, пушит в git и отчитывается — а люди всё это время видят происходящее и остаются в контуре.
|
|
10
|
-
|
|
11
|
-
Этот пакет — та часть, что работает **на вашей машине**.
|
|
12
|
-
|
|
13
|
-
## Что он делает
|
|
14
|
-
|
|
15
|
-
- **Даёт вашему агенту инструменты платформы по MCP** — взять следующую задачу, прочитать контекст и документы проекта, задать вопрос человеку, попросить подтверждение на опасное действие, сдать работу.
|
|
16
|
-
- **Ставит хуки в вашего агента**, чтобы shell-команда проверялась по профилю доверия проекта *до* выполнения. Команда из стоп-списка получает отказ; команда, требующая человека, — вопрос человеку.
|
|
17
|
-
- **Держит соединение и аренду задачи**, чтобы платформа знала: над задачей работают, а не бросили её.
|
|
18
|
-
|
|
19
|
-
Содержимое ваших файлов никуда не отправляется — только имена, пути и команды.
|
|
20
|
-
|
|
21
|
-
## Что нужно
|
|
22
|
-
|
|
23
|
-
- Node.js 22 или новее
|
|
24
|
-
- Учётная запись на платформе Quiel, участие в проекте и хотя бы одна роль в нём
|
|
25
|
-
- Токен агента — выдаётся один раз, на странице «Агенты» проекта
|
|
26
|
-
|
|
27
|
-
## Установка
|
|
28
|
-
|
|
29
|
-
```bash
|
|
30
|
-
npm i -g @quiel/cli
|
|
31
|
-
quiel --version
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
## Быстрый старт
|
|
35
|
-
|
|
36
|
-
Выполните в каталоге своего проекта:
|
|
37
|
-
|
|
38
|
-
```bash
|
|
39
|
-
quiel init
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
Команда спросит, какой у вас агент (найденный в каталоге предложит первым), адрес платформы, токен, ключ проекта, ID агента и роли. Если агент известен заранее — можно без вопроса:
|
|
43
|
-
|
|
44
|
-
```bash
|
|
45
|
-
quiel init --agent codex
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
Затем **перезапустите сессию своей программы**. Это обязательный шаг, а не совет: MCP-сервер поднимается только при старте сессии. Без перезапуска агент не появится, сколько бы раз вы ни выполняли `init`.
|
|
49
|
-
|
|
50
|
-
```bash
|
|
51
|
-
quiel status --check # соединение, режим, текущая задача
|
|
52
|
-
quiel connect # держит соединение с платформой
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
Чтобы агент начал брать задачи сам:
|
|
56
|
-
|
|
57
|
-
```bash
|
|
58
|
-
quiel mode auto
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
## Какие агенты поддерживаются
|
|
62
|
-
|
|
63
|
-
| Агент | Кто делает | `--agent` | Состояние |
|
|
64
|
-
|---|---|---|---|
|
|
65
|
-
| Claude Code | Anthropic | `claude-code` | Проверено живым прогоном |
|
|
66
|
-
| Codex | OpenAI | `codex` | Бета |
|
|
67
|
-
| Cursor | Anysphere | `cursor` | Бета |
|
|
68
|
-
| OpenCode | SST | `opencode` | Бета |
|
|
69
|
-
|
|
70
|
-
Клиент один на всех. Инструменты платформы — это MCP, отраслевой стандарт, и они работают одинаково везде; различаются только формат хуков и файлы конфигурации, и клиент пишет те, что нужны выбранному агенту.
|
|
71
|
-
|
|
72
|
-
### Что означает «бета»
|
|
73
|
-
|
|
74
|
-
Поддержка Codex, Cursor и OpenCode сделана по официальной документации каждой платформы и покрыта тестами, но **живым прогоном пока не проверена**. На практике это значит: инструменты появятся, а защиту проверьте сами — попросите агента выполнить заведомо запрещённую команду и убедитесь, что она не прошла. Не считайте, что стоп-паттерны вас защищают, пока не увидели отказ своими глазами.
|
|
75
|
-
|
|
76
|
-
`quiel init` и `quiel status` говорят об этом вслух для таких агентов.
|
|
77
|
-
|
|
78
|
-
Два пробела, о которых стоит знать. Ни один из них не наша недоделка: платформа просто не сообщает о таком событии, и перехватывать нечего.
|
|
79
|
-
|
|
80
|
-
| | Claude Code | Codex | Cursor | OpenCode |
|
|
81
|
-
|---|---|---|---|---|
|
|
82
|
-
| Инструменты платформы (MCP) | да | да | да | да |
|
|
83
|
-
| Запрет опасных команд | да | да | да | да |
|
|
84
|
-
| Защита файлов по путям | да | да | **нет** | да |
|
|
85
|
-
| Автономный режим | да | да | да | да |
|
|
86
|
-
| Переход в «Лимит запросов» сам | да | **нет** | **нет** | да |
|
|
87
|
-
|
|
88
|
-
**Отдельно про OpenCode:** у него была ошибка, из-за которой вызовы инструментов *из субагента* не поднимали плагины вовсе ([sst/opencode#5894](https://github.com/anomalyco/opencode/issues/5894) — закрыт, но версия с исправлением не названа). Инструкция Quiel как раз велит агенту делегировать работу субагенту — проверьте отказ именно через субагента.
|
|
89
|
-
|
|
90
|
-
## Что записывает `quiel init`
|
|
91
|
-
|
|
92
|
-
Всё ложится в каталог проекта, поэтому видно в `git status` и доступно для просмотра:
|
|
93
|
-
|
|
94
|
-
| Агент | Файлы |
|
|
95
|
-
|---|---|
|
|
96
|
-
| Claude Code | `.claude/settings.json`, `.mcp.json`, секция в `CLAUDE.md`, `.claude/commands/quiel-auto.md` |
|
|
97
|
-
| Codex | `.codex/hooks.json`, `.codex/config.toml`, секция в `AGENTS.md` |
|
|
98
|
-
| Cursor | `.cursor/hooks.json`, `.cursor/mcp.json`, секция в `AGENTS.md` |
|
|
99
|
-
| OpenCode | `opencode.json`, `.opencode/plugins/quiel.js`, секция в `AGENTS.md` |
|
|
100
|
-
|
|
101
|
-
Плюс одна строка в `.gitignore` — для каталога, в котором работает агент.
|
|
102
|
-
|
|
103
|
-
**Токен не попадает ни в один из них.** Он лежит отдельно, в `~/.quiel/credentials.json` с правами `0600`, вне репозитория. В `.quiel.json` — том файле, который коммитится, — только адрес платформы, ключ проекта, ID агента, его роли и выбранная агентская программа.
|
|
104
|
-
|
|
105
|
-
Существующая конфигурация сливается, а не перезаписывается: чужие MCP-серверы, чужие хуки и ваши комментарии сохраняются. Повторный `init` — это штатный способ переподключить агента, и он ничего не дублирует.
|
|
106
|
-
|
|
107
|
-
## Команды
|
|
108
|
-
|
|
109
|
-
| Команда | Что делает |
|
|
110
|
-
|---|---|
|
|
111
|
-
| `quiel init` | Подключить проект: `.quiel.json`, конфигурация агента, секция в инструкциях |
|
|
112
|
-
| `quiel connect` | Держит соединение с платформой |
|
|
113
|
-
| `quiel status [--check]` | Показывает проект, настроенную программу, режим и текущую задачу |
|
|
114
|
-
| `quiel mode auto\|manual` | Переключает автономный и ручной режим |
|
|
115
|
-
| `quiel mcp` | Запускает MCP-сервер по stdio (это делает сам агент) |
|
|
116
|
-
| `quiel hook <name> [--format …]` | Вызывает хук (это делает конфигурация агента) |
|
|
117
|
-
|
|
118
|
-
## Сообщить о проблеме
|
|
119
|
-
|
|
120
|
-
Issues открыты: **https://github.com/Quiel-AI/quiel-cli/issues**
|
|
121
|
-
|
|
122
|
-
Приложите, пожалуйста, вывод:
|
|
123
|
-
|
|
124
|
-
```bash
|
|
125
|
-
quiel --version
|
|
126
|
-
quiel status
|
|
127
|
-
```
|
|
128
|
-
|
|
129
|
-
`quiel status` **не** печатает ваш токен. Но он печатает адрес платформы, ключ проекта и ID агента — замажьте их, если это важно.
|
|
130
|
-
|
|
131
|
-
## Об этом репозитории
|
|
132
|
-
|
|
133
|
-
Здесь — документация и трекер задач для `@quiel/cli`. Quiel — коммерческий продукт: клиент распространяется собранным пакетом под закрытой лицензией, исходники здесь не публикуются. Что клиент делает с вашей машиной, описано выше, и каждый файл, который он пишет, лежит в вашем же каталоге проекта — его можно прочитать.
|
|
134
|
-
|
|
135
|
-
## Лицензия
|
|
136
|
-
|
|
137
|
-
Закрытая (`UNLICENSED`). © Quiel. Все права защищены.
|