@innominatum/agentforge-cli 1.1.9 → 1.1.23

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.
Files changed (5) hide show
  1. package/.github/workflows/publish.yml +4 -7
  2. package/dist/index.js +313 -263
  3. package/package.json +1 -1
  4. package/src/index.ts +337 -299
  5. package/templates/CLI_MANUAL.md +55 -82
package/templates/CLI_MANUAL.md CHANGED
@@ -1,10 +1,10 @@
1
- # AgentForge Workspace 🤖⚒️
1
+ # AgentForge CLI Workspace 🤖⚒️
2
2
 
3
- Welcome to your AgentForge Workspace! This repository is managed by the `agentforge` CLI, which allows you to scaffold, manage, build, and deploy AI Agents and Skills for the GoClaw platform.
3
+ Bem-vindo ao Workspace do AgentForge! Este repositório é gerido inteiramente pela `agentforge` CLI, a ferramenta definitiva para criar, editar, sincronizar e fazer deploy em massa de Agentes AI e Skills para a plataforma GoClaw.
4
4
 
5
- ## Getting Started
5
+ ## Primeiros Passos
6
6
 
7
- To start a new project for your agents, create an empty folder, navigate into it, and initialize the workspace:
7
+ Para iniciar um novo projeto, crie uma pasta vazia, entre nela e corra a inicialização:
8
8
 
9
9
  ```bash
10
10
  mkdir my-ai-agents
@@ -12,113 +12,86 @@ cd my-ai-agents
12
12
  agentforge init
13
13
  ```
14
14
 
15
- This will create the necessary directory structure and the configuration file (`agentforge.json`).
16
-
17
- ---
18
-
19
- ## Workspace Structure
20
- After running the `init` command, your workspace will look like this:
15
+ ## Estrutura do Workspace
21
16
 
22
17
  ```text
23
18
  my-ai-agents/
24
- ├── agentforge.json # Your workspace configuration and GoClaw API credentials
25
- ├── agents/ # Where your local agents will live
26
- ├── documents/ # Reference documentation for your AI assistants
27
- ├── exports/ # Where built files are stored for deployment
28
- ├── skills/ # Where your local skills will live
29
- └── templates/ # Customizable templates for your Agents and Skills
19
+ ├── agentforge.json # Configuração e credenciais da API GoClaw
20
+ ├── agents/ # Todos os seus Agentes (Configurações e Memórias)
21
+ ├── documents/ # Documentação de referência
22
+ ├── exports/ # Arquivos empacotados prontos para deploy
23
+ ├── skills/ # As suas Skills locais
24
+ └── templates/ # Templates personalizáveis para Agentes e Skills
30
25
  ```
31
26
 
32
27
  ---
33
28
 
34
- ## Commands
29
+ ## 🚀 Comandos de Deploy (Upload para GoClaw)
35
30
 
36
- ### Workspace Sync
37
- When you clone a repository or set up a new workspace, you can synchronize all remote assets to your local machine at once.
31
+ Estes comandos enviam as suas alterações locais (Verdade Absoluta) para o servidor GoClaw, sobrescrevendo a nuvem.
38
32
 
39
- ```bash
40
- agentforge pull all
41
- ```
42
- Downloads all agents and skills from the GoClaw server. It performs a **surgical extraction**, retrieving only the core `agent.json`, `context_files/`, and skill definitions to keep your workspace perfectly clean. Note: This will ask for confirmation before overwriting local files.
33
+ ### Em Massa (Bulk Deploy)
34
+ - **`agentforge deploy all`**
35
+ Faz o deploy completo de TODOS os Agentes e TODAS as Skills. Ideal para sincronizar a equipa inteira de uma só vez.
36
+ - **`agentforge deploy agents`**
37
+ Faz o deploy completo de TODOS os agentes na sua pasta `agents/`.
38
+ - **`agentforge deploy skills`**
39
+ Empacota e envia TODAS as skills na sua pasta `skills/`.
43
40
 
44
- ### Bulk Deployment
45
- ```bash
46
- agentforge deploy agents
47
- ```
48
- Performs a full deployment (config + context + memory) for **all agents** found in your `agents/` directory.
41
+ ### Específicos por Agente / Skill
42
+ - **`agentforge deploy agent <slug>`**
43
+ Atualiza a configuração (`agent.json`) E sincroniza todos os ficheiros de contexto e memória para um agente específico.
44
+ - **`agentforge deploy context <slug>`**
45
+ *Hot Reload:* Envia apenas os ficheiros de contexto (`.md`, `.txt`, pastas de memória) de um agente, ignorando a configuração. Ideal para iteração rápida.
46
+ - **`agentforge deploy skill <slug>`**
47
+ Empacota uma skill individual em `.zip` e envia para a API do GoClaw.
49
48
 
50
- ```bash
51
- agentforge deploy skills
52
- ```
53
- Packages and uploads **all skills** (including those in the `system/` directory) found in your `skills/` directory.
49
+ ---
54
50
 
55
- ```bash
56
- agentforge deploy all
57
- ```
58
- Performs a full deployment for **all agents and skills**. This is the most efficient way to synchronize your entire team and toolset after making cross-cutting changes.
51
+ ## 📥 Comandos de Pull (Download do GoClaw)
59
52
 
60
- ### Agent Management
61
- ```bash
62
- agentforge new agent "<Agent Name>"
63
- ```
64
- Creates a new agent inside the `agents/` directory. The default `agent_type` is now `predefined`, aligning with GoClaw's official standard for agents with established personalities.
53
+ Estes comandos **apagam o estado local** e descarregam a Verdade Absoluta que está no servidor GoClaw.
65
54
 
66
- ```bash
67
- agentforge pull agents
68
- ```
69
- Downloads all agents from the GoClaw server and extracts them locally. It automatically reconstructs memory files from GoClaw's internal JSONL format back into readable Markdown files.
55
+ - **`agentforge pull all`**
56
+ Sincronização nuclear: Descarrega e extrai todos os Agentes e Skills do servidor GoClaw para as pastas locais.
57
+ - **`agentforge pull agents`**
58
+ Faz o download de todos os Agentes (Configuração + Ficheiros de Contexto e Memória).
59
+ - **`agentforge pull skills`**
60
+ Faz o download do arquivo de exportação de Skills do servidor e extrai tudo para a pasta `skills/`.
70
61
 
71
- ```bash
72
- agentforge deploy agent <slug>
73
- ```
74
- **Full Deployment:** Reads the local `agent.json` to create or update an agent. Then, it synchronizes all context files and memory (including `MEMORY.md` and the `memory/` folder).
75
-
76
- ```bash
77
- agentforge deploy context <slug>
78
- ```
79
- **Hot Reload for Context & Memory:** Fast-path deployment that uploads all local context files (`.md`, `.txt`, `.py`) and memory data directly to the server.
62
+ ---
80
63
 
81
- ### Skill Management
82
- ```bash
83
- agentforge new skill "<Skill Name>"
84
- ```
85
- Creates a new skill inside the `skills/` directory using the template from `templates/default-skill/SKILL.md`.
64
+ ## 🛠️ Criação e Gestão (Scaffolding)
86
65
 
87
- ```bash
88
- agentforge pull skills
89
- ```
90
- Downloads the latest backup archive of all skills and extracts them locally.
66
+ - **`agentforge new agent "<Nome do Agente>"`**
67
+ Gera a estrutura base de um novo Agente na pasta `agents/` (usando o template predefinido).
68
+ - **`agentforge new skill "<Nome da Skill>"`**
69
+ Cria uma nova Skill na pasta `skills/` pronta a programar.
70
+ - **`agentforge build skill <slug>`**
71
+ Empacota uma skill num ficheiro `.zip` (guardado em `exports/`) sem enviar para o servidor.
91
72
 
92
- ```bash
93
- agentforge build skill <slug>
94
- ```
95
- Packages the skill folder into a `.zip` file ready for GoClaw deployment. The resulting archive is saved in the `exports/` folder.
73
+ ---
96
74
 
97
- ```bash
98
- agentforge deploy skill <slug>
99
- ```
100
- Automatically builds your skill into a `.zip` file and securely uploads it to your GoClaw server via the Upload API.
75
+ ## 🧠 Sincronização de Memória e Contexto (Advanced)
101
76
 
102
- ---
77
+ O AgentForge CLI tem um sistema cirúrgico de gestão de memória. Qualquer ficheiro colocado na pasta raiz do agente ou na pasta `memory/` será injetado no cérebro do agente:
103
78
 
104
- ## Memory Support 🧠
105
- AgentForge CLI handles agent memory as first-class citizens:
106
- - **MEMORY.md**: Use this file at the root of your agent folder for curated, long-term memory.
107
- - **memory/**: Any files inside this folder (e.g., chat histories, user-specific facts) are synchronized.
108
- - **Auto-Conversion**: When pulling, the CLI converts GoClaw's `.jsonl` exports back into `.md` files for easier editing in VS Code.
79
+ 1. **Flattening Automático:** O CLI converte a estrutura de pastas em prefixos compatíveis com a API do GoClaw (ex: `memory/ficheiro.md` passa a `memory_ficheiro.md` na nuvem, mas mantém a pasta na sua máquina).
80
+ 2. **Edição Forçada (Overwrite Protection Bypass):** Se editar um ficheiro de memória localmente, o CLI executa automaticamente uma operação cirúrgica (`PUT`) na Base de Dados Semântica do GoClaw para forçar a alteração.
81
+ 3. **Exterminação de Fantasmas (Pruning):** Se apagar um ficheiro localmente, ao fazer `deploy`, o CLI não só o apaga da Base de Dados Semântica do GoClaw, como neutraliza o ficheiro físico no servidor (injetando zero-bytes), garantindo que ele não volta a aparecer (efeito fantasma) nos futuros `pulls`.
109
82
 
110
83
  ---
111
84
 
112
- ## Configuration
113
- Before using the deployment commands, make sure to add your GoClaw Bearer Token to the `agentforge.json` file:
85
+ ## ⚙️ Configuração (agentforge.json)
86
+
87
+ Garanta que tem o token correto antes de usar comandos de sincronização:
114
88
 
115
89
  ```json
116
90
  {
117
91
  "goclaw": {
118
- "api_url": "http://localhost:18790",
92
+ "api_url": "https://<seu-servidor-goclaw>",
119
93
  "token": "YOUR_BEARER_TOKEN",
120
- "default_provider": "ollama cloud",
121
- "default_model": "deepseek-v4-pro"
94
+ "username": "O Seu ID de Utilizador GoClaw (Ex: 8642756972)"
122
95
  }
123
96
  }
124
97
  ```