Home

27. Adapting to a Lobster-Like Framework

If You Already Have a Working Local Agent Framework

If your current system already does model calls and basic tool execution, do not rebuild everything. Treat this source as an upgrade guide.

What To Port Into an Existing Framework

  • Better CLI shell organization
  • Better Bash safety boundaries
  • More explicit tool contracts
  • Session memory and compacting ideas
  • Richer prompt input and message rendering patterns

What Not To Port Blindly

  • Anthropic-specific API logic
  • Feature-flag-heavy branches
  • Background agent complexity before your core loop is stable
  • Large UI surface if your users do not need it

Practical Migration Rule

Upgrade one layer at a time: first tool contracts, then safety, then session management, then optional UX polish. Do not import complexity faster than your local model and current framework can support.

Source Navigation

Recommended Source Files

  • source/tools.ts
  • source/Tool.ts
  • source/tools/AgentTool/AgentTool.tsx
  • source/services/mcp/auth.ts
  • source/services/SessionMemory/sessionMemory.ts

Next Files to Read

  • source/services/tools/toolOrchestration.ts
  • source/services/api/client.ts
  • source/components/messages

Related Chapters