Getting Started

Creating Your First Project

Set up your first Hissuno project, configure its settings, and learn your way around the dashboard.

Prerequisites

You need a running Hissuno instance. If you haven't set one up yet:

npm i -g hissuno
hissuno setup

What Is a Project?

A project in Hissuno represents a single product or service you want to track customer feedback for. Each project has its own feedback sessions, issues, knowledge sources, and AI agent configuration. Most teams create one project per product.

Creating a Project

You can create a project from the dashboard or via the CLI.

From the Dashboard

  1. From the dashboard, click New Project in the sidebar or on the projects overview page.
  2. Enter a project name that identifies the product (e.g., "Acme Web App" or "Mobile API").
  3. Optionally add a short description to help teammates understand what this project covers.
  4. Click Create Project.

From the CLI

npm install -g hissuno
hissuno config

The config wizard will configure your API key and auto-detect your project. You can also create projects and manage data directly from the terminal. See CLI for all available commands.

You will be redirected to the new project's dashboard, which is initially empty. The next sections explain how to populate it.

Once inside a project, the sidebar provides direct access to each section. There is no centralized settings page -- instead, each area is a top-level sidebar item:

  • Dashboard -- Overview of project activity, recent feedback, and key metrics.
  • Feedback -- All customer conversations collected from connected sources and the widget.
  • Issues -- Actionable items extracted from feedback sessions.
  • Customers -- Directory of everyone who has interacted through your feedback channels.
  • Agents -- Configure the AI agents and manage knowledge sources.
  • Integrations -- Connect third-party tools and configure the embeddable widget.
  • Access -- Manage team members, roles, and API keys.

Agents

The Agents page manages Hissuno's two AI agents:

  • Support Specialist -- Powers customer conversations using your project's knowledge sources to answer questions accurately.
  • Product Specialist -- Analyzes feedback sessions, creates and upvotes issues, and generates product specifications.

From the Agents page, you can also manage knowledge sources that give the AI agents context about your product. Click the knowledge sources dialog to connect:

  • Codebases -- Link a GitHub repository so Hissuno can analyze your source code and extract product knowledge automatically.
  • Documents -- Upload product specs, FAQs, runbooks, or any reference material in Markdown or PDF format.
  • URLs -- Point to public documentation pages that should be indexed.

See Add Your Data for detailed instructions.

Integrations

The Integrations page lets you connect third-party tools that feed customer conversations into Hissuno. Supported integrations include Intercom, Slack, Gong, and more. Each integration creates feedback sessions automatically.

The widget integration is also configured here. Click the Widget card and then Configure to copy the project ID and authentication keys. See Widget Installation for setup instructions.

Dashboard Orientation

The project dashboard is your central hub. Here is a breakdown of each section accessible from the sidebar.

Feedback

The feedback list shows all customer conversations collected from your connected sources and widget. Each entry displays:

  • The customer name or identifier.
  • A short summary generated by the AI.
  • Tags such as bug, feature_request, or change_request applied automatically.
  • The date and current status.

Click any feedback session to open the detail view, which includes the full conversation transcript, AI-generated analysis, and linked issues.

Issues

Issues are actionable items extracted from feedback sessions. Hissuno's PM agent reviews incoming feedback and either creates new issues or upvotes existing ones when multiple customers report the same problem.

The issues board supports:

  • Filtering by status, priority, or tag.
  • Sorting by vote count, creation date, or last activity.
  • Linking back to the originating feedback sessions for full context.

Customers

The customers section provides a directory of everyone who has interacted through your feedback channels. Each customer profile aggregates:

  • All feedback sessions from that customer.
  • Issues they have contributed to.
  • Contact metadata such as email, company, and custom properties.

You can import customer data via CSV or let Hissuno populate profiles automatically from incoming conversations.

Agents

The Agents section shows the compiled product knowledge that powers the AI agents. After connecting sources and running an analysis, you will see categorized knowledge packages covering business context, product features, and technical details.

Tips for Getting Started

  • Connect at least one knowledge source before testing the AI agent. The agent performs best when it has product context to draw from.
  • Start with a single feedback channel and expand once you are comfortable with the workflow.
  • Review the first few auto-generated issues to calibrate the AI. You can edit issue titles, adjust priorities, and merge duplicates.
  • Invite your team early. Shared visibility into customer feedback helps prioritize the right work.

Next Steps

With your project created, continue to Add Your Data to start feeding customer conversations into Hissuno.