skills.rest
lsongdev
lsongdevCOMMUNITY
Explore all skills by this author →
Website𝕏@lsongdevGitHub

miya-desktop

Configure and troubleshoot Miya Desktop providers, profiles, agents, and runtime files.

Updated Jul 20, 2026
Search Tags:#troubleshooting#configuration#agents#json#providers#mcp servers#miya desktop
One-click install
npx skills add https://github.com/lsongdev/skills --skill miya-desktop-lsongdev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: miya-desktop
Source: https://github.com/lsongdev/skills/tree/main/miya-desktop
Command: npx skills add https://github.com/lsongdev/skills --skill miya-desktop-lsongdev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Miya Desktop stores its configuration in local JSON files and runtime directories, and editing them incorrectly can break providers, agents, or sessions. This Skill guides safe inspection and modification of that configuration without corrupting data or exposing secrets. ## Core Features & Use Cases - Configuration Management: Edit providers, profiles, agents, MCP servers, and channels in ~/.miya/config.json while preserving unknown fields and valid JSON formatting. - Runtime Navigation: Locate workspaces, skills, sessions, conversation caches, and logs under the ~/.miya directory. - Safe Troubleshooting: Diagnose setup issues with rules that protect API keys, avoid deleting session data, and prefer the Settings UI when possible. - Use Case: A user renames an API provider and needs every profile referencing the old name updated consistently without losing other settings. ## Quick Start Ask the assistant to update the Miya Desktop provider configuration in ~/.miya/config.json and explain which services need to reconnect afterward.

Frequently Asked Questions about miya-desktop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I change a provider in Miya Desktop config?▼

Edit the providers section in ~/.miya/config.json, then update every profile that references the old provider name. Read the existing JSON first, preserve unrelated fields, and reconnect or restart affected services afterward.

Where does Miya Desktop store its configuration and sessions?▼

Miya Desktop stores shared configuration in ~/.miya/config.json, sessions in ~/.miya/sessions, conversation snapshots in ~/.miya/cache/conversations, logs in ~/.miya/logs, and the default workspace in ~/.miya/workspace.

What is the difference between profiles and agents in Miya Desktop?▼

Profiles are built-in agents that reference a provider and model with optional workspace and token limits. The agents section contains only external ACP endpoints, and built-in agents derived from profiles must not be duplicated there.

Which provider types does Miya Desktop support?▼

Miya Desktop currently supports openai and anthropic provider types. A provider entry must use one of these supported types to be valid in the configuration.

When should I edit the Miya config file directly instead of the Settings UI?▼

Prefer the Desktop Settings UI for ordinary changes. Edit ~/.miya/config.json directly only when the UI cannot express the requested configuration, and always keep valid JSON with two-space indentation.

Related Skills

Explore More Software Engineering Skills→
SpillwaveSolutionsSpillwaveSolutions
14

memory-llm

Configure LLM providers for agent-memory summarization via interactive wizard.

Official
Advanced
dokipendokipen
1

agent-service

Manage AI agent sessions via hub-based JSON-RPC methods.

Community
Advanced
DTMC-marketplaceDTMC-marketplace

gemini-mcp-integration

Configure MCP servers with Gemini CLI via HTTP, SSE, and Stdio transports.

Official
Intermediate
letta-ailetta-ai
3.2k

editing-letta-code-desktop-preferences

Edits Letta Code Desktop preferences by merging updates into the desktop_preferences.json file.

Official
Basic