---
title: "Add notes and contributions"
url: "https://docs.alisx.com/how-to/ideate/add-notes-and-contributions/"
---
# 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](https://docs.alisx.com/how-to/ideate/upload-recordings-and-documents.md). |

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.

```bash title="Terminal"
alis ideate add note --project <project> --file note.md
```

Or inline:

```bash title="Terminal"
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.

## Related

- [Upload recordings and documents](https://docs.alisx.com/how-to/ideate/upload-recordings-and-documents.md)
- [Ask questions about a project](https://docs.alisx.com/how-to/ideate/ask-questions-about-a-project.md)
- Reference: [`alis ideate add note`](https://docs.alisx.com/reference/projects/cli.md#alis-ideate-add-note)