Skip to main content
Live. This area is documented as current, user-reliable behavior.

​
Goal

Prepare an existing repository for StackShift with OpenCode.

​
Prerequisites

  • OpenCode installed with a configured model provider.
  • The StackShift CLI release containing setup agent.

​
Workflow

1
Open a terminal in your project and run opencode. Use /connect if your model provider is not configured.
2
Ask OpenCode to read https://stackshift.cloud/prompt.md and prepare the repository for StackShift.
3
Alternatively, run stackshift setup agent —client opencode from the repository root, then start a new OpenCode session.
4
Use stackshift auth login for StackShift account access, then ask the agent to inspect the project before requesting deployment.

​
Project-local setup (next CLI release)

This flow installs guidance for OpenCode and uses the StackShift CLI. It does not install OpenCode, configure its model provider, or configure MCP. Existing project instructions and other providers are preserved. The skill includes repository setup, databases, Assets, S2, Mail, migration and recovery guidance. It grants no additional permissions. Restart OpenCode after installation for discovery. OpenCode is supported by this local setup flow; it is not advertised as a qualified StackShift MCP client.

​
Official references

OpenCode setup OpenCode skills

​
Expected result

StackShift guidance is installed in .opencode/skills/stackshift-cloud-operations. Installation alone does not deploy or create resources.

​
Common failures

  • An older CLI may not recognize opencode; install the release containing this client.
  • Modified local skill files are preserved. Review differences before replacing them.

Connect your coding agent

Connect an external client, choose its access and inspect its work in StackShift.