feat(setup): add native Devin CLI and Desktop support
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 48/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- go
- Domain
- cli, developer-experience
Research direction
Start with internal/setup/agents.go and the existing windsurf target, then inspect CLI command registration and usage tests to see how setup targets are configured. Check the Devin CLI MCP configuration and Devin Local customization formats described in the issue. Done means a documented setup command configures both Devin surfaces while preserving the legacy windsurf path and its existing behavior.
Written by the indexing model from the issue text.
Description
Existing Issue Search
- I searched existing issues and will add evidence to a canonical tracker when applicable.
🔍 Observed Consequence
Engram users who have moved from Windsurf to Devin Desktop or use Devin CLI cannot configure the current Devin agent with engram setup. The only related setup target is windsurf, which configures legacy Cascade paths under ~/.codeium/windsurf/; Devin Local and Devin CLI use Devin's own shared customization and MCP configuration.
As a result, engram setup windsurf can preserve legacy Cascade compatibility but does not register Engram for the current Devin Local/CLI agent surfaces.
💡 Desired Outcome
Engram users can run one documented setup command that makes the Engram MCP tools and Memory Protocol available to both Devin CLI and Devin Local in Devin Desktop, while existing Windsurf/Cascade users keep their current compatibility path.
📦 Affected Area
CLI (commands, flags)
Release Context
Current main at ec2bf0482139360bf61a8eadb76380ffe762de44; not release-specific.
🔄 Workarounds and Constraints
Users can currently register Engram manually with devin mcp add -s user engram -- engram mcp --tools=agent and add the Memory Protocol to Devin rules themselves. Devin Local in Desktop and Devin CLI share the same customization format, so users should not need two separate manual configurations.
📎 Additional Context
- Engram currently documents only the legacy Windsurf/Cascade target: https://github.com/Gentleman-Programming/engram/blob/main/docs/AGENT-SETUP.md#windsurf
- The target writes
~/.codeium/windsurf/mcp_config.jsonand~/.codeium/windsurf/memories/global_rules.md: https://github.com/Gentleman-Programming/engram/blob/main/internal/setup/agents.go - Devin CLI user-scope MCP configuration is
~/.config/devin/mcp_config.json: https://docs.devin.ai/cli/extensibility/mcp/configuration - Devin Local shares its customization system with Devin CLI: https://docs.devin.ai/desktop/devin-local/customizations
- Windsurf became Devin Desktop on June 2, 2026, while legacy Windsurf settings remain migration inputs: https://docs.devin.ai/desktop/devin-desktop-faq
Proportional verification scope if approved: add focused setup registry/path/preservation tests, update CLI usage tests, and align README, installation, and per-agent setup documentation. Preserve the existing windsurf target as a distinct legacy compatibility surface.
- Dominant language
- Go
- Stars
- 7.1k
- Forks
- 729
- Avg merge
- 12h 9m
- Merged PRs (30d)
- 282
Getting set up
Starts the project's dev container in your browser, under your own GitHub account.
- No Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from Gentleman-Programming/engram
-
status:needs-review
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
Gentleman-Programming/engram#2065 · 1 comment ·
Maintainers usually reply within 1 day
-
question(test): stable request storage for existing EINTR scenariosPossibly taken @dnlrsls claimed this 1 day ago. Openstatus:needs-review type:question
Gentleman-Programming/engram#2291 · 1 assignee ·
Maintainers usually reply within 1 day
-
status:needs-review
Difficulty 4/5 3-5 days Newbie friendliness 38/100
Gentleman-Programming/engram#2278 · 1 comment ·
Maintainers usually reply within 1 day
-
bug(cli): upgrading the binary leaves a stale server and nothing reports the pending restartPossibly taken @dnlrsls claimed this 3 days ago. Openstatus:approved type:bug
Gentleman-Programming/engram#2242 · 5 comments · 1 assignee ·
Maintainers usually reply within 1 day
-
bug(claude-code): session binding rewrites mem_save input, so auto mode denies memory writesPossibly taken @dnlrsls claimed this 3 days ago. Openstatus:needs-review type:bug
Gentleman-Programming/engram#2231 · 4 comments · 1 assignee ·
Maintainers usually reply within 1 day
All issues in Gentleman-Programming/engram
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
router-for-me/CLIProxyAPI#7330 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Maintainers usually reply within 1 day
-
bug os:ios
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
hajimehoshi/ebiten#4039 · 2 comments ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
Maintainers usually reply within 9 days