You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
docs: document agentop configure bob and agentop configure bobshell #1237
agentop configure bob and agentop configure bobshell both ship in v0.8.1 and neither has a user-facing page. No doc under docs/ mentions Bob at all outside internal research notes.
cmd/agentop/cmd_bob.go supports:
agentop configure bob enable [--yes] [--settings PATH] [--config PATH]
agentop configure bob disable [--yes] [--settings PATH] [--config PATH]
agentop configure bob status [--settings PATH] [--config PATH]
Points worth documenting, all read from the v0.8.1 source:
IBM Bob is a VS Code fork, so it has a flat settings.json and exactly one key decides its networking: http.proxy. Only that key is written; everything else is left alone.
Default settings path is macOS only: ~/Library/Application Support/IBM Bob/User/settings.json. On other platforms --settings is required.
The proxy address comes from ~/.cortex/config.yaml, so it matches the proxy actually running.
The CA is ca.crt (notbundle.crt), at ~/.cortex/ca/ca.crt, and machine-wide trust goes in /Library/Keychains/System.keychain.
agentop configure bobshell is a different thing — the source says the two are independent. The docs must not blur them.
Proposed Solution
A page covering bobenable / disable / status, with real output
State the macOS-only default path, and what to pass on other platforms
Explain the single http.proxy key and that other settings are untouched
The CA trust step: ca.crt, not bundle.crt, and the keychain scope
Cover bobshell separately, and say plainly how it differs from bob
How to undo both, and how to confirm
Verified against a release binary
Additional Context
Split out of #959, which covered the first-run spine and is closed. Companion issue covers Claude Code.
Related: #943 (Bob support) tracks the feature work; this issue is only the documentation.
docs/agents/bob.md covers each item: enable, disable and status, the http.proxy key, the macOS-only default and --settings on other platforms, ca.crt against bundle.crt, the keychain undo, and the shell rc block.
bobshell is no longer a separate command. It became part of configure bob on 2026-10-15 (cmd/agentop/cmd_configure.go:133). Thus a separate page for it is not necessary.
Note: bob.md lines 37 and 71 still refer to configure bobshell as a command.
Activity
docs: correct the latency reading, and cover the new agentop surfaces
docs: correct the latency reading, and cover the new agentop surfaces (…
huang195 commentedon Nov 6, 2026
docs/agents/bob.mdcovers each item:enable,disableandstatus, thehttp.proxykey, the macOS-only default and--settingson other platforms,ca.crtagainstbundle.crt, the keychain undo, and the shell rc block.bobshellis no longer a separate command. It became part ofconfigure bobon 2026-10-15 (cmd/agentop/cmd_configure.go:133). Thus a separate page for it is not necessary.Note:
bob.mdlines 37 and 71 still refer toconfigure bobshellas a command.Assisted-By: Claude (Anthropic AI) noreply@anthropic.com