myagent

Files (3)

• SKILL.md
• native-mcp.md · references/
• webhooks.md · references/

SKILL.md (first lines)

# MyAgent

MyAgent is an open-source AI agent framework by Nous Research that runs in your terminal, messaging platforms, and IDEs. It belongs to the same category as Claude Code (Anthropic), Codex (OpenAI), and OpenClaw — autonomous coding and task-execution agents that use tool calling to interact with your system. MyAgent works with any LLM provider (OpenRouter, Anthropic, OpenAI, DeepSeek, local models, and 15+ others) and runs on Linux, macOS, and WSL.

What makes MyAgent different:

- **Self-improving through skills** — MyAgent learns from experience by saving reusable procedures as skills. When it solves a complex problem, discovers a workflow, or gets corrected, it can persist that knowledge as a skill document that loads into future sessions. Skills accumulate over time, making the agent better at your specific tasks and environment.
- **Persistent memory across sessions** — remembers who you are, your preferences, environment details, and lessons learned. Pluggable memory backends (built-in, Honcho, Mem0, and more) let you choose how memory works.
- **Multi-platform gateway** — the same agent runs on Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Email, and 10+ other platforms with full tool access, not just chat.
- **Provider-agnostic** — swap models and providers mid-workflow without changing anything else. Credential pools rotate across multiple API keys automatically.
- **Profiles** — run multiple independent MyAgent instances with isolated configs, sessions, skills, and memory.
- **Extensible** — plugins, MCP servers, custom tools, webhook triggers, cron scheduling, and the full Python ecosystem.

People use MyAgent for software development, research, system administration, data analysis, content creation, home automation, and anything else that benefits from an AI agent with persistent context and full system access.

**This skill helps you work with MyAgent effectively** — setting it up, configuring features, spawning additional agent instances, troubleshooting issues, finding the right commands and settings, and understanding how the system works when you need to extend or contribute to it.

**Docs:** https://myagent.nousresearch.com/docs/

## Quick Start

```bash
# Install
curl -fsSL https://myagent.nousresearch.com/install.sh | bash

# Interactive chat (default)
myagent

# Single query
myagent chat -q "What is the capital of France?"

# Setup wizard
myagent setup

# Change model/provider
myagent model

# Check health
myagent doctor
```

---

## CLI Reference

### Global Flags

```
myagent [flags] [command]

  --version, -V             Show version
  --resume, -r SESSION      Resume session by ID or title
  --continue, -c [NAME]     Resume by name, or most recent session
  --worktree, -w            Isolated git worktree mode (parallel agents)
  --skills, -s SKILL        Preload skills (comma-separate or repeat)
  --profile, -p NAME        Use a named profile
  --yolo                    Skip dangerous command approval
  --pass-session-id         Include session ID in system prompt
```

No subcommand defaults to `chat`.

### Chat

```
myagent chat [flags]
  -q, --query TEXT          Single query, non-interactive
  -m, --model MODEL         Model (e.g. anthropic/claude-sonnet-4)
  -t, --toolsets LIST       Comma-separated toolsets
  --provider PROVIDER       Force provider (openrouter, anthropic, nous, etc.)
  -v, --verbose             Verbose output
  -Q, --quiet               Suppress banner, spinner, tool previews
  --checkpoints             Enable filesystem checkpoints (/rollback)
  --source TAG              Session source tag (default: cli)
```

### Configuration

```
myagent setup [section]      Interactive wizard (model|terminal|gateway|tools|agent)
myagent model                Interactive model/provider picker
myagent config               View current config
myagent config edit          Open config.yaml in $EDITOR
myagent config set KEY VAL   Set a config value
myagent config path          Print config.yaml path
myagent config env-path      Print .env path
myagent config check         Check for missing/outdated config
myagent config migrate       Update config with new options
myagent auth                 Interactive credential manager
myagent auth add PROVIDER    Add OAuth or API-key credential (e.g. nous, openai-codex, qwen-oauth)
myagent auth list            List stored credentials
myagent auth remove PROVIDER Remove a stored credential
myagent doctor [--fix]       Check dependencies and config
myagent status [--all]       Show component status
```

### Tools & Skills

```
myagent tools                Interactive tool enable/disable (curses UI)
myagent tools list           Show all tools and status
myagent tools enable NAME    Enable a toolset
myagent tools disable NAME   Disable a toolset

myagent skills list          List installed skills
myagent skills search QUERY  Search the skills hub
myagent skills install ID    Install a skill (ID can be a hub identifier OR a direct https://…/SKILL.md URL; pass --name to override when frontmatter has no name)
myagent skills inspect ID    Preview without installing
myagent skills config        Enable/disable skills per platform
myagent skills check         Check for updates
myagent skills update        Update outdated skills
myagent skills uninstall N   Remove a hub skill
myagent skills publish PATH  Publish to registry
myagent skills browse        Browse all available skills
myagent skills tap add REPO  Add a GitHub repo as skill source
```

### MCP Servers

From ashiqcodeleaf/long-Run-Agents, MIT.