---
title: "Command line and Claude Code plugin"
description: "npx talalevel runs every TalaLevel tool from a terminal with a workspace key. The Claude Code plugin adds the connector and a skill for working a sales floor."
url: https://talalevel.com/docs/cli/
date: 2026-11-12
updated: 2026-11-12
---

# Command line and Claude Code plugin

npx talalevel is a small Node command with no dependencies. It runs the same tools the MCP server has, with a workspace API key. A command that sends asks first, and needs --yes when no person is at the terminal.

## Install

Nothing to install. With Node on the machine:

```sh
npx talalevel login          # paste the key from Settings → Connections → API and webhooks
npx talalevel tools          # what this key may do
npx talalevel help get_lead  # one command's options
```

The package is [`talalevel` on npm](https://www.npmjs.com/package/talalevel). Its source is public at [github.com/bcssewl/talalevel](https://github.com/bcssewl/talalevel).

## Commands

The commands are the [MCP server's tools](https://talalevel.com/docs/mcp/#read-tools) by the same names. Options are the tool's inputs.

```sh
npx talalevel search_leads --query "reed auto"
npx talalevel get_lead --lead_id 123
npx talalevel add_note --lead_id 123 --text "Owner back Monday"
npx talalevel set_task --lead_id 123 --next_action "Send the proposal" --due 2026-11-14
npx talalevel search_calls --reached human --from 2026-11-10
npx talalevel send_text --lead_id 123 --text "Hi Marcus, Dana here. Does 9:30 still work?" --yes
```

- Output is short text. `--json` gives the fields.
- `talalevel tools` lists only what the key may run, so a read-only key shows no change or send commands.

## Sending

A command that reaches a lead, or starts a batch, a wave or the AI caller, asks before it goes.

- At a terminal it asks you.
- Anywhere else it needs `--yes`. A coding agent should pass `--yes` only after the person has said yes to that exact send.
- Batches, waves and AI caller runs are previewed first. The start command takes the preview's id.

## The key

| Where | Notes |
| --- | --- |
| `talalevel login` | Reads the key from standard input and saves it in a file only you can read. |
| `TALALEVEL_KEY` | An environment variable. Overrides the saved key. |

The key is never passed as an argument, so it does not end up in shell history or a process list.

## Claude Code plugin

```sh
claude plugin marketplace add bcssewl/talalevel
claude plugin install talalevel@talalevel
```

The plugin adds two things:

- The **connector**: the MCP server at `https://app.talalevel.com/mcp`, signed in as you.
- The **`talalevel` skill**: how to work a sales floor with the connector or the command line, such as prepping a call, clearing follow-ups, or building a call list.

To add only the connector:

```sh
claude mcp add --transport http talalevel https://app.talalevel.com/mcp
```

## Questions

### Is there a TalaLevel CLI?

Yes: npx talalevel. It needs Node and a workspace API key, and its commands are the MCP server's tools by the same names.

### How do I use TalaLevel from Claude Code?

Either add the MCP server (claude mcp add --transport http talalevel https://app.talalevel.com/mcp) or install the plugin from the bcssewl/talalevel marketplace, which adds the connector and a skill.