fuigo 1.0.7 → 1.0.8

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 (2) hide show
  1. package/README.md +76 -31
  2. package/package.json +7 -7
package/README.md CHANGED
@@ -1,57 +1,102 @@
1
1
  # Fuigo
2
2
 
3
- Bring Fuigo into your terminal. Fast, flicker-free CLI built for plans, subagents, and parallel work.
3
+ **An engine for AI that can act, collaborate, and remember.**
4
+
5
+ Fuigo is a general-purpose, multi-provider AI agent engine for research, analysis, creation, and work across connected tools. Its Rust runtime provides execution, persistent sessions, subagents, permission controls, and workspace-scoped cross-session memory. Built-in tools work with files, search, and terminal commands; configured MCP servers extend its reach into external services.
6
+
7
+ Work alongside it in the terminal, request files or structured outputs from a script, or use ACP to build your own application interface. Specialized document formats and external operations depend on the tools you connect.
8
+
9
+ [Source and full setup guide](https://github.com/FerroxLabs/fuigo) · [Documentation](https://github.com/FerroxLabs/fuigo/tree/main/crates/codegen/fuigo-pager/docs/user-guide)
4
10
 
5
11
  ## Install
6
12
 
7
- ```bash
8
- npm i -g fuigo
13
+ Requires Node.js 20 or newer:
14
+
15
+ ```sh
16
+ npm install -g fuigo@latest
17
+ fuigo --version
9
18
  ```
10
19
 
11
- npm downloads only the binary matching your platform, not all six.
20
+ The launcher selects your platform binary. Packages target macOS, Linux, and Windows on arm64 and x64.
12
21
 
13
- ## Get Started
22
+ ## Connect a model
14
23
 
15
- ```bash
16
- # Launch the interactive TUI
17
- fuigo
24
+ | Route | Supported connection |
25
+ | --- | --- |
26
+ | OpenAI directly | API key; Chat Completions or Responses |
27
+ | Anthropic directly | API key; Messages API |
28
+ | Flux Router and compatible gateways | Supported API protocol and gateway credentials |
29
+ | Local models, including Ollama | OpenAI-compatible endpoint |
30
+ | ChatGPT and Grok subscriptions | Explicit provider login and entitled models |
18
31
 
19
- # Run a single task
20
- fuigo -p "Explain this codebase"
32
+ ### Direct API keys
33
+
34
+ Set `OPENAI_API_KEY` or `ANTHROPIC_API_KEY` in your environment, then add the corresponding entry to `~/.fuigo/config.toml`. Replace model placeholders with IDs available to your account:
35
+
36
+ ```toml
37
+ [model.openai]
38
+ model = "REPLACE_WITH_YOUR_OPENAI_MODEL_ID"
39
+ base_url = "https://api.openai.com/v1"
40
+ api_backend = "responses" # or "chat_completions"
41
+ env_key = "OPENAI_API_KEY"
42
+
43
+ [model.anthropic]
44
+ model = "REPLACE_WITH_YOUR_CLAUDE_MODEL_ID"
45
+ base_url = "https://api.anthropic.com/v1"
46
+ api_backend = "messages"
47
+ auth_scheme = "x_api_key"
48
+ env_key = "ANTHROPIC_API_KEY"
49
+ extra_headers = { "anthropic-version" = "2023-06-01" }
21
50
  ```
22
51
 
23
- On first launch, Fuigo helps you set up a provider. For CI or headless environments, set an API key directly:
52
+ Run `fuigo -m openai` or `fuigo -m anthropic`. The Anthropic configuration sends the key as `x-api-key`. Set context and output limits for your selected model; use `env_http_headers` for additional secret gateway headers.
53
+
54
+ ### Subscriptions
24
55
 
25
- ```bash
26
- export FUIGO_API_KEY="fuigo-..."
56
+ ```sh
57
+ fuigo login --provider chatgpt
58
+ fuigo models --provider chatgpt
27
59
  ```
28
60
 
29
- ## Update
61
+ Add a named model to `~/.fuigo/config.toml`, replacing the placeholder with a model ID from the list:
62
+
63
+ ```toml
64
+ [auth_provider.chatgpt-subscription]
65
+ subscription = "chatgpt"
30
66
 
31
- ```bash
32
- fuigo update
67
+ [model.chatgpt-subscription]
68
+ model = "REPLACE_WITH_MODEL_ID_FROM_LIST"
69
+ base_url = "https://chatgpt.com/backend-api/codex"
70
+ auth_provider = "chatgpt-subscription"
33
71
  ```
34
72
 
35
- Or if installed via npm:
73
+ ```sh
74
+ # Work interactively in your project
75
+ fuigo -m chatgpt-subscription
36
76
 
37
- ```bash
38
- npm i -g fuigo@latest
77
+ # Return structured output from a bounded task
78
+ fuigo -m chatgpt-subscription -p "Compare the proposals in this folder" --output-format json --max-turns 4
79
+
80
+ # Run as an agent for an ACP-capable client
81
+ fuigo agent --model chatgpt-subscription stdio
39
82
  ```
40
83
 
41
- ## Supported Platforms
84
+ For Grok subscriptions, Flux Router, and compatible gateways, follow the [full setup guide](https://github.com/FerroxLabs/fuigo#connect-a-model). The [custom-model guide](https://github.com/FerroxLabs/fuigo/blob/main/crates/codegen/fuigo-pager/docs/user-guide/11-custom-models.md) also includes local Ollama configuration. Features depend on the selected model and protocol. Subscription login does not import other applications' credentials, and a subscription denial does not silently fall back to a paid API key.
85
+
86
+ Fuigo 1.0.8 enables local workspace memory by default. Global sharing, remote embeddings and automatic background model processing are opt-in. Use `/remember`, `/flush`, `/dream`, and `/memory` to manage it; set `[memory] enabled = false` to disable it. Applications can choose their own policy. Lexical search needs no embedding service.
87
+
88
+ ## Update
89
+
90
+ ```sh
91
+ npm install -g fuigo@latest
92
+ ```
42
93
 
43
- | Platform | Architecture |
44
- |---|---|
45
- | macOS | Apple Silicon (arm64), Intel (x86_64) |
46
- | Linux | x86_64, arm64 |
47
- | Windows | x86_64, arm64 |
94
+ ## Bundle the engine
48
95
 
49
- ## Documentation
96
+ Pin a Fuigo version and include the matching `@fuigo` platform package when distributing it with an application. Your application can launch `fuigo agent stdio` and handle the ACP interface. The Rust workspace is implementation source, not a separately versioned public SDK. Preserve the included license and attribution files when redistributing the engine.
50
97
 
51
- Fuigo ships its own documentation. Run `/docs` inside the TUI, or read the
52
- extracted copy under `~/.fuigo/docs/user-guide/`, covering configuration, MCP
53
- servers, custom models, headless mode and agent mode.
98
+ ## Documentation and licensing
54
99
 
55
- ## Feedback
100
+ Run `/docs` in the terminal or read the [source documentation](https://github.com/FerroxLabs/fuigo/tree/main/crates/codegen/fuigo-pager/docs/user-guide) for permissions, sandboxing, model configuration, MCP, headless tasks, and ACP integration.
56
101
 
57
- Run `/feedback` inside Fuigo to report issues or send feedback directly.
102
+ Fuigo is licensed under Apache-2.0. See the included `LICENSE`, `NOTICE`, and third-party notices for origin, modification, and dependency attribution. Fuigo originated as a modified derivative of Grok Build and is independently maintained by Ferrox Labs; it is not affiliated with or endorsed by xAI or SpaceXAI.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "fuigo",
3
- "version": "1.0.7",
3
+ "version": "1.0.8",
4
4
  "description": "Bring Fuigo into your terminal",
5
5
  "license": "Apache-2.0",
6
6
  "bin": {
@@ -40,11 +40,11 @@
40
40
  "@iarna/toml": "^3.0.0"
41
41
  },
42
42
  "optionalDependencies": {
43
- "@fuigo/darwin-arm64": "1.0.7",
44
- "@fuigo/darwin-x64": "1.0.7",
45
- "@fuigo/linux-arm64": "1.0.7",
46
- "@fuigo/linux-x64": "1.0.7",
47
- "@fuigo/win32-arm64": "1.0.7",
48
- "@fuigo/win32-x64": "1.0.7"
43
+ "@fuigo/darwin-arm64": "1.0.8",
44
+ "@fuigo/darwin-x64": "1.0.8",
45
+ "@fuigo/linux-arm64": "1.0.8",
46
+ "@fuigo/linux-x64": "1.0.8",
47
+ "@fuigo/win32-arm64": "1.0.8",
48
+ "@fuigo/win32-x64": "1.0.8"
49
49
  }
50
50
  }