# @nextappco/agent

Install NEXT in Claude Code, Claude Desktop, Codex, Cursor, GitHub Copilot CLI, GitHub Copilot in VS Code, and Agy. The installer adds the portable NEXT configuration skill and the authenticated MCP connections the skill uses.

## Setup

```bash
npx @nextappco/agent setup
```

The interactive setup detects supported agents and asks for a NEXT API token. [Create a project token in NEXT](https://help.nextapp.co/docs/settings/teamspace/general/security/create-api-token/).

The integration is installed globally. The project token is stored in the selected agents' MCP configuration in plaintext for this first version.

### Headless setup

Read the token from stdin to keep it out of shell history:

```bash
printenv NEXT_PROJECT_TOKEN | npx @nextappco/agent setup --token-stdin --yes
```

Alternatively, set `NEXT_PROJECT_TOKEN` or pass `--token`. The latter may expose the token in shell history and process listings.

Select agents explicitly when auto-detection is unavailable:

```bash
npx @nextappco/agent setup --agent claude-code --agent codex --yes
```

Claude Desktop uses `mcp-remote` to bridge its local stdio MCP interface to NEXT's remote servers. It is downloaded through `npx` when Claude Desktop first starts the integration.

## Status and removal

```bash
npx @nextappco/agent status
npx @nextappco/agent remove
```

`status` checks the skill, both internal MCP configurations, and—when it can read a configured token—the live MCP connections. Use `--json` for machine-readable output.

`remove` deletes only NEXT-managed MCP entries. The shared skill remains while another supported agent still has NEXT configured.

Run `npx @nextappco/agent <command> --help` for all options. Restart or reload an agent after setup or removal.

## Development

```bash
npm install
npm run check
npm pack --dry-run
```
