Tags

Tags are the primary way to categorize and filter ideas in NeuralRepo. Every idea can have up to 20 tags, and each tag name can be up to 50 characters long.

Creating Tags

Tags are created on the fly when you assign them to an idea. There is no separate “create tag” step — just start using a tag and it exists.

Open an idea and click the + Add Tag button in the sidebar. Type a tag name and press Enter. The tag is created and assigned immediately.

# Add one or more tags to an idea
nrepo tag <id> <tags...>

# Examples
nrepo tag 42 ai machine-learning
nrepo tag 18 side-project weekend

curl -X PATCH https://neuralrepo.com/api/v1/ideas/42 \
  -H "Authorization: Bearer $NREPO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tags": ["ai", "machine-learning"]}'

Tag Format

Tags should follow these conventions for best results:

Rule	Example
Lowercase	`machine-learning` not `Machine-Learning`
Hyphenated for multi-word	`side-project` not `side project`
Max 50 characters	Enforced by the API
Max 20 tags per idea	Additional tags are rejected with a `400` error

Auto-Classification

When you create an idea without any tags, NeuralRepo can automatically suggest and apply tags using Workers AI. The auto-classifier analyzes the idea title and body to generate relevant tags.

Auto-classification runs asynchronously after idea creation. You will see tags appear on your idea within a few seconds.

Custom Colors

Assign a custom color to any tag to make it visually distinct across the web app — on the kanban board, in search results, and in the mind map.

Click on any tag in the sidebar, then select Edit Color. Choose a color from the picker or enter a hex value directly.

curl -X PATCH https://neuralrepo.com/api/v1/tags/ai \
  -H "Authorization: Bearer $NREPO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"color": "#6366f1"}'

Colors must be in #rrggbb hex format.

Filtering by Tag

Find all ideas with a specific tag across every surface.

Click any tag in the left sidebar to filter the idea list. You can select multiple tags to narrow results further.

# List ideas filtered by tag
nrepo log --tag ai

# Combine with status filter
nrepo log --tag ai --status exploring

# Filter ideas by tag
GET /api/v1/ideas?tag=ai

# Multiple tags (intersection)
GET /api/v1/ideas?tag=ai&tag=mobile-app

Bulk Operations

Add or remove a tag from multiple ideas at once using the CLI.

# Add a tag to multiple ideas
nrepo tag add ai --ids 1,2,3

# Remove a tag from multiple ideas
nrepo tag remove deprecated --ids 4,5

Bulk operations are atomic — if any idea ID is invalid, the entire operation fails and no changes are applied.

Listing Tags with Counts

Retrieve all tags in your repository along with the number of ideas each tag is applied to.

GET /api/v1/tags

Response:

{
  "tags": [
    { "name": "ai", "color": "#6366f1", "count": 14 },
    { "name": "mobile-app", "color": null, "count": 8 },
    { "name": "side-project", "color": "#f59e0b", "count": 5 }
  ]
}

nrepo tags

Outputs a table of all tags sorted by idea count.

Limits

Limit	Value
Tags per idea	20
Tag name length	50 characters
Color format	`#rrggbb` hex