Skip to content

Add notes and contributions

Put what you know into a project as a contribution: a typed note, a voice memo, a screen recording, or a note written from the CLI. Everyone with access to the project sees what you add, and Alis works it into the project's Synthesis and artifacts.

Prerequisites

  • Editor or Owner access on the project. A project you can only read shows a Viewer chip; ask an owner for Editor access.

Add a note or recording in the console

  1. Open the project and click Contributions.
  2. Click Add contribution.

  3. Choose how to contribute; you can combine them in one contribution:

    Control What it adds
    The Note box A typed note.
    Record a voice note A voice memo, transcribed when it arrives. Stop recording adds it to the contribution; Discard recording throws it away. A very short recording is rejected as Too short.
    Record screen A screen recording with your microphone. Grant the browser permission to share your screen and use the microphone when asked.
    Upload files One or more files. You can also drop or paste them in. See Upload recordings and documents.

  4. Click Add contribution.

The contribution appears in the feed with your name. A recording shows "Still reading this file" until its transcript is ready.

Add context by conversation

After you add a contribution, Talk it through opens a chat with Alis about what you just added. Alis reads it and asks what would give it more context. Use this when you would rather talk than write. Add another starts a fresh contribution instead.

Add a note from the CLI

Write the note as markdown for someone who was not there: what was found or decided, the numbers and names that matter, and what is still open. If it comes from a document, say which one.

alis ideate add note --project <project> --file note.md

Or inline:

alis ideate add note --project <project> --text "Decided on 12 June: onboarding moves to a two-step flow. Open: who owns the email templates."

--file - reads the note from stdin. --project takes the bare id or the full ideas/<id> name. The command asks for confirmation; pass --yes to skip it in a script. The new contribution is printed; read it back with alis ideate contribution <contribution> --project <project>.

A note is the right choice for anything you have already read and understood. Do not paste logs, code dumps or generated output; a note saying what they show is worth more than the file.

Remove a contribution

  1. On Contributions, open the contribution.
  2. Choose Remove contribution and confirm.

It is removed from the project and excluded from future artifact generation.