Slack Report Share

Overview

• POST /v1/slack/messages/agent-cli-report

agent_cli_report

Authentication

• Resolve key in this order:

  1. FASTFOLD_API_KEY

     from environment
  2. FastFold CLI config

     ~/.fastfold-cli/config.json

     (

     api.fastfold_cloud_key

     )
• Do not ask users to paste secrets into chat.
• If key is still missing:
  • Default guidance (generic agents): ask the user to set

    FASTFOLD_API_KEY

    in environment or

    .env

    .
  • Only if user is explicitly using FastFold CLI, you may suggest:

    • fastfold setup

    • fastfold config set api.fastfold_cloud_key <key>

When to Use

• User asks to share/export a session report to Slack.
• User asks to send markdown summary to the team's report channel.
• User asks to save a report in the library and Slack in one step.

Agent Workflow

1. Export or prepare markdown report content.
2. Call the helper script:

   • python scripts/send_agent_cli_report.py --markdown-file <path>

   • Do not replace this with ad-hoc Python

     requests

     code.
3. If response has

   ok: false

   and

   needs_slack_setup: true

   , tell user:
   • Configure Slack at https://cloud.fastfold.ai/integrations/slack
   • Set a channel for

     agent_cli_report

     .
4. If response includes

   library_item_id

   , include this open link in the reply:

   • https://cloud.fastfold.ai/code/<library_item_id>?from=library

Friendly Failure Message

• https://cloud.fastfold.ai/integrations/slack

Resources

• API details: references/api.md