Migrate from Claude Code or Codex

Release status

RightNow Agent is coming soon for Windows, macOS and Linux. Installation commands and workflows in these guides are reference material until the public release is available.

This page covers the repository-provided Windows PowerShell helper for copying selected Claude Code or Codex assets into RightNow Agent. Run the repository script from its checkout after reviewing the preview; the helper does not modify the source directories.

Repository migration helper

Run these commands from the RightNow Agent repository root in Windows PowerShell. The helper is not part of the native installation. With -WithMcp, config/rightnow.toml must be available to seed a missing destination config.toml.

Preview the migration.
powershell
```
.\migrate-to-rightnow.ps1 -DryRun
```
Dry run: no directories or files will be created or changed. For eligible paths, this preview reports missing destinations as WOULD COPY and existing destinations as SKIP existing.
After reviewing the preview, apply the migration.
powershell
```
.\migrate-to-rightnow.ps1
```
For eligible paths, the helper creates destination directories as needed and reports COPIED for new files. Existing destinations are skipped unless -Force is supplied.

Parameter	Behavior
-From auto\|claude\|codex	Selects the source. Default: auto, which picks each tool found in %USERPROFILE%.
-RightNowHome <path>	Selects the destination. Default: %USERPROFILE%\.rightnow.
-WithMcp	Opts in to MCP import.
-DryRun	Makes no destination file or directory changes.
-Force	Permits replacement of destination collisions.

Without -Force, existing asset files are skipped. With -WithMcp, new MCP server names merge into config.toml; -Force permits replacing conflicting server definitions. Destination paths must remain inside the selected RightNow home, and existing reparse points in that path are refused. The helper exits 1 when it reports a problem.

What is copied and what loads

Copied into the RightNow home	Loads by default in 1.0.5
skills/from .claude/skills/	Only with [skills] machine_wide = true.
commands/from .claude/commands/, .codex/prompts/	Only with machine_wide = true.
agents/from .claude/agents/	Yes, as user agents.
rules/from .claude/rules/	Top-level .md files, as rules.
rules/CLAUDE.md, rules/AGENTS.md, rules/AGENTS.override.mdfrom .claude/CLAUDE.md, .codex/AGENTS.md, .codex/AGENTS.override.md	Yes, as rules. The override file does not replace AGENTS.md.

Sources are read from %USERPROFILE% and copied as they are, without conversion. Sessions, transcripts, caches, authentication state, and general application settings are not included.

MCP import

Review imported MCP servers

MCP definitions are imported only with -WithMcp. Review every imported command, argument, environment variable, URL, and header before launching.

Sources: the top-level mcpServers in %USERPROFILE%\.claude.json (unsupported fields are skipped with a note; RightNow already reads this file in place, see MCP Servers) and the [mcp_servers.*] tables in %USERPROFILE%\.codex\config.toml, copied as written.

After migration, inspect the summary and destination files, set RIGHTNOW_API_KEY, and launch with rightnow.

In-app Claude import

The installed CLI also has /import-claude. It copies the Claude Code permissions, environment variables, MCP servers, and hooks you pick into ~/.rightnow/config.toml or the project's .rightnow/config.toml; hooks go to hooks/imported-from-claude.json. After an import or a dismiss, RightNow stops reading Claude Code settings, ~/.claude.json, and .mcp.json at runtime. .claude/skills/ and .claude/rules/ still do not load.