beecork 2.3.0 → 2.4.0
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/README.md +31 -3
- package/dist/index.js +1845 -1155
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -58,11 +58,37 @@ outside (or any shell command) goes through a permission gate.
|
|
|
58
58
|
### Tools
|
|
59
59
|
|
|
60
60
|
`read_file` · `show` · `write_file` · `edit_file` · `list_dir` · `search` · `run_bash` ·
|
|
61
|
-
`web_fetch` · `web_search` · `update_todos` · `remember`
|
|
61
|
+
`web_fetch` · `web_search` · `update_todos` · `remember` · `ask_user` · `check_task` · `stop_task` · `explore`
|
|
62
|
+
|
|
63
|
+
### Background tasks
|
|
64
|
+
|
|
65
|
+
`run_bash` can run a command **in the background** (dev servers, watchers, long builds): the agent gets
|
|
66
|
+
a task id immediately and polls it with `check_task` / stops it with `stop_task`. Background tasks stay
|
|
67
|
+
up across turns and are all killed when beecork exits.
|
|
68
|
+
|
|
69
|
+
### Mid-turn steering
|
|
70
|
+
|
|
71
|
+
While the agent is working, just **type a message and press Enter** — it's queued and picked up on the
|
|
72
|
+
next step, without cancelling the turn ("also update the README", "no, use pnpm"). Ctrl-C still cancels.
|
|
73
|
+
|
|
74
|
+
### Sub-agents (`explore`)
|
|
75
|
+
|
|
76
|
+
The agent can delegate an open-ended investigation to a **read-only sub-agent** that explores on its own
|
|
77
|
+
(reading, searching, browsing the web) in a separate context and returns just a summary — keeping the
|
|
78
|
+
main conversation clean. It cannot modify anything, run commands, or recurse.
|
|
62
79
|
|
|
63
80
|
### Slash commands
|
|
64
81
|
|
|
65
|
-
`/model` · `/key` · `/update` · `/context` · `/clear` · `/resume` · `/good` · `/bad` · `/help` · `Shift+Tab` (rotate mode) · `exit`
|
|
82
|
+
`/model` · `/effort` · `/key` · `/update` · `/context` · `/clear` · `/resume` · `/good` · `/bad` · `/help` · `Shift+Tab` (rotate mode) · `exit`
|
|
83
|
+
|
|
84
|
+
### Reasoning ("thinking")
|
|
85
|
+
|
|
86
|
+
For models that support it, beecork can ask the model to reason before answering. Set the depth
|
|
87
|
+
with `/effort <off|low|medium|high|max>` (persists across restarts) or the `REASONING_EFFORT` env
|
|
88
|
+
var; default is `medium`. It uses OpenRouter's unified `reasoning` parameter, so it works across
|
|
89
|
+
every provider (deepseek, GLM, Gemini, Claude, OpenAI, …), and is only sent to models that advertise
|
|
90
|
+
support. The thinking streams dimly, distinct from the answer. Note: reasoning tokens bill as output
|
|
91
|
+
tokens.
|
|
66
92
|
|
|
67
93
|
### Memory
|
|
68
94
|
|
|
@@ -78,6 +104,8 @@ All variables are read from the real shell environment only (never a project fil
|
|
|
78
104
|
|---|---|---|
|
|
79
105
|
| `OPENROUTER_API_KEY` | OpenRouter API key (required) | — |
|
|
80
106
|
| `OPENROUTER_MODEL` | Model id | `deepseek/deepseek-v4-flash` |
|
|
107
|
+
| `REASONING_EFFORT` | Reasoning depth: `off`/`low`/`medium`/`high`/`max` | `medium` |
|
|
108
|
+
| `OPENROUTER_EXTRA` | Advanced: JSON of extra request-body params (`temperature`, `seed`, provider routing, …) | — |
|
|
81
109
|
| `BRAVE_API_KEY` | Brave Search key (for `web_search`) | — |
|
|
82
110
|
| `VERIFY_COMMAND` | Command auto-run after edits (e.g. `npm run typecheck`) | — |
|
|
83
111
|
| `AUTO_APPROVE` | Headless: skip approval prompts (out-of-root/risky shell are still hard-denied) | off |
|
|
@@ -87,7 +115,7 @@ All variables are read from the real shell environment only (never a project fil
|
|
|
87
115
|
| `WEB_TIMEOUT_MS` | `web_fetch` / `web_search` timeout | `20000` |
|
|
88
116
|
| `MAX_CONTEXT_TOKENS` | Compact the conversation above this | `128000` |
|
|
89
117
|
|
|
90
|
-
Other tunables (`KEEP_RECENT`, `MAX_TOOL_RESULT_CHARS`, `RETRY_ATTEMPTS`, `API_TIMEOUT_MS`, `SEARCH_*`, `VERIFY_TIMEOUT_MS`, `TRACE_FILE`) are defined in `src/config.ts`.
|
|
118
|
+
Other tunables (`KEEP_RECENT`, `MAX_TOOL_RESULT_CHARS`, `RETRY_ATTEMPTS`, `API_TIMEOUT_MS`, `SEARCH_*`, `VERIFY_TIMEOUT_MS`, `TRACE_FILE`, `MAX_BG_TASKS`, `BG_TAIL_CHARS`, `SUBAGENT_MAX_STEPS`) are defined in `src/config.ts`.
|
|
91
119
|
|
|
92
120
|
## Development
|
|
93
121
|
|