Skip to content
Kura-chan Docs
Home

Create the Slack app

A Slack app is the bot identity Kura-chan uses. The fastest way to create one with the right scopes, events, and all eight slash commands is from a manifest — a single block of configuration you paste in.

Create from the manifest

Section titled “Create from the manifest”

  1. Open the app list

    Go to api.slack.com/apps and click Create New App.

  2. Choose “From a manifest”

    Pick the workspace you want Kura-chan to live in, then Next.

  3. Paste the manifest

    Switch to the YAML tab, replace the contents with the block below, then Next → Create. You can rename name and display_name to anything you like.

    display_information:
      name: Kura-chan
      description: Your personal AI agent in Slack
      background_color: "#000000"
    features:
      app_home:
        home_tab_enabled: true
        messages_tab_enabled: false
        messages_tab_read_only_enabled: false
      bot_user:
        display_name: Kura-chan
        always_online: true
      shortcuts:
        - name: Capture to Kura
          type: message
          callback_id: kura_capture
          description: Save this message to Kura-chan
      slash_commands:
        - command: /kura-ask
          description: Quick question
          should_escape: false
        - command: /kura-search
          description: Search knowledge base
          should_escape: false
        - command: /kura-summary
          description: Channel summary
          should_escape: false
        - command: /kura-digest
          description: Daily digest
          should_escape: false
        - command: /kura-remind
          description: Set reminder
          should_escape: false
        - command: /kura-files
          description: Recent files
          should_escape: false
        - command: /kura-model
          description: Switch model
          should_escape: false
        - command: /kura-help
          description: Show help
          should_escape: false
    oauth_config:
      scopes:
        bot:
          - app_mentions:read
          - channels:history
          - chat:write
          - commands
          - files:read
          - files:write
          - groups:history
          - im:history
          - im:read
          - im:write
          - im:write.topic
          - mpim:history
          - mpim:read
          - mpim:write
          - reactions:read
          - reactions:write
          - users:read
      pkce_enabled: true
    settings:
      event_subscriptions:
        bot_events:
          - app_home_opened
          - app_mention
          - message.channels
          - message.groups
          - message.im
      interactivity:
        is_enabled: true
      org_deploy_enabled: false
      socket_mode_enabled: true
      token_rotation_enabled: false
      is_mcp_enabled: false

What the manifest sets up

Section titled “What the manifest sets up”
  • Socket Mode — the outbound connection, so no public URL is needed.
  • Bot scopes — posting (chat:write), slash commands (commands), reading and uploading files (files:read, files:write), reading messages across DMs, group DMs, and channels (im:*, mpim:*, groups:history, channels:history), starting and naming DMs (im:write, im:write.topic), mentions (app_mentions:read), reactions (reactions:read, reactions:write), and resolving who’s talking (users:read).
  • Events — app_mention, direct / group / channel messages (message.im, message.groups, message.channels), and app_home_opened.
  • Interactivity, the App Home tab, and a “Capture to Kura” message shortcut (right-click any message → save it to Kura-chan).
  • All eight /kura-* slash commands.

Next, generate and copy your credentials: The two tokens.

Prefer to set it up by hand?

Section titled “Prefer to set it up by hand?”
Manual setup checklist (no manifest)

After Create New App → From scratch, configure each section:

  1. Socket Mode (Settings → Socket Mode): toggle Enable Socket Mode on.
  2. OAuth & Permissions → Bot Token Scopes, add all of: app_mentions:read, channels:history, chat:write, commands, files:read, files:write, groups:history, im:history, im:read, im:write, im:write.topic, mpim:history, mpim:read, mpim:write, reactions:read, reactions:write, users:read.
  3. Event Subscriptions: enable events, then under Subscribe to bot events add: app_home_opened, app_mention, message.channels, message.groups, message.im.
  4. Interactivity & Shortcuts: toggle Interactivity on, then Create New Shortcut → On messages, name it Capture to Kura with callback ID kura_capture.
  5. App Home: enable the Home Tab (the Messages tab can stay off).
  6. Slash Commands: create each of the eight commands by hand — /kura-ask, /kura-search, /kura-summary, /kura-digest, /kura-remind, /kura-files, /kura-model, /kura-help. With Socket Mode on, leave the Request URL blank.