Intelligence Chat & Feature Mode

The Intelligence Chat lets you ask questions about your code navigation architecture and get AI-generated answers grounded in the actual code and connections Codity has indexed. Feature Mode extends this into architecture planning: the AI can propose new components and visualize them directly on the diagram.

Opening the Chat

The chat panel sits to the right of the Architecture Diagram on wide screens, and below it on smaller screens. It is always visible when you are on the Code Navigation page.

Asking Questions

Type any question about your repositories into the input area at the bottom of the panel and press Enter or click Send. The AI answers using the repos and connections currently visible in your diagram as context.

Example questions:

  • "Which repos depend on the analytics service?"
  • "How does codity.ai communicate with scanner-service?"
  • "What would break if I changed the API contract in codity-ingress?"
  • "Who are the top contributors across all connected repos this month?"
  • "Which repos have failing CI checks?"
  • "Show me all open PRs where I was requested as reviewer"

The AI streams its answer in real time. Responses support full markdown (code blocks, tables, bold, links), and code blocks include a copy button.

Attaching Files

Click the paperclip icon in the input area to attach a file. Supported formats: PDF and Word documents. The file contents are sent alongside your message so the AI can reason about them.

Panel Controls

Branches: opens a drawer listing all selected repositories and the branches currently being analyzed for each. Use this to confirm the AI is reasoning over the branches you expect.

Export PDF: downloads the entire current chat as a PDF. Only available when the conversation has messages.

Feature Mode

Feature Mode switches the AI from answering questions to planning new architecture. When active, the AI outputs structured cards that appear as Proposed nodes on the diagram.

Activating Feature Mode

Click the Feature mode button (lightning bolt icon) in the chat header. The button turns purple when active.

Using Feature Mode

With Feature Mode on, describe a new capability or infrastructure component you want to add. The AI will:

  1. Explain the approach and how it fits your existing architecture
  2. Generate one or more Proposed cards representing new components
  3. Show those cards on the diagram connected to the relevant repos
  4. Provide an implementation roadmap broken into phases

Example prompts:

  • "Add a Redis caching layer shared between codity.ai and scanner-service"
  • "We need a message queue between the ingress and the analytics pipeline"
  • "Design a notification service that reads from the database and sends emails"

Proposed Cards on the Diagram

Each card the AI generates appears on the Architecture Diagram immediately with:

  • A "PROPOSED" label and purple-tinted dashed border to distinguish it from permanent nodes
  • Dashed edges connecting it to the repos the AI identified as relevant
  • The card name and type (database, queue, cache, gateway, external, or custom)

Proposed cards are not saved permanently. They exist for the current session to help you visualize the plan. To make a card permanent, recreate it using the Add Connection panel (see Add Connections).

Turning Off Feature Mode

Click the Feature mode button again to deactivate it. The button returns to its default appearance. The AI reverts to answering questions. Proposed cards remain on the diagram until the chat is reset.