Skip to content

Create a proper installation and usage instruction for opencode #149

@markokocic

Description

@markokocic

I'm aware of the OpenCode wiki entry, but the information there is not up to date.

Given the recent OpenCode popularity and open-source nature, it may warrant its own entry next to Claude Code in the project's main README file.

How I configured it in opencode is I put the following in my ~/.opencode/opencode.json :

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "clojure-mcp": {
      "type": "local",
      "command": ["clojure", "-Tmcp", "start"],
      "enabled": false
    },
    "clojure-mcp-cli-assist": {
      "type": "local",
      "command": ["clojure", "-Tmcp", "start", ":config-profile", ":cli-assist"],
      "enabled": false
    }
  }
}

This configures both the default and the :cli-assist profiles globally but lets them be disabled by default. Then, when inside a Clojure project, I do /mcp to enable one of them and start the nrepl server manually.

What I'm not sure about is which one I should use. I tried both but didn't notice any big difference. The distinction is not apparent. Which one should I use? Which one is "better"? Or do I need something else?

README also mentions users may try the mpc-clojure-light project for CLI tools, but both README here and in the light project don't explain what the difference is and what the relation is between the :cli-assist profile and the clojure-mcp-light project.

I also noticed that the source code for the cli-assist profile mentions disabling some tools, but the comments are about Claude Code, so I can't be sure if the same applies to OpenCode and other CLI tools as well, or if we need to create a new custom profile?

TL;DR: Please provide beginner-friendly documentation on how to get started with OpenCode and mcp-clojure.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions