# AI Capabilities
Source: https://docs.trilo.chat/ai-coworkers/ai-capabilities
Explore the full range of what AI coworkers can do for you
AI coworkers in Trilo are capable of helping with a wide variety of tasks. This guide covers their key capabilities and how to make the most of them.
## Writing & Content
### Drafting Content
AI coworkers can write many types of content:
* **Emails**: Professional correspondence, follow-ups, announcements
* **Documents**: Reports, proposals, specifications
* **Messages**: Slack messages, announcements, updates
* **Social media**: Posts, threads, captions
* **Marketing**: Copy, taglines, descriptions
**Example:**
```
"Write a product announcement email for our new analytics dashboard.
Target audience is existing customers. Include the main features:
real-time data, custom reports, and mobile access."
```
### Editing & Improving
Get help polishing your writing:
* Fix grammar and spelling
* Improve clarity and flow
* Adjust tone and style
* Simplify complex content
* Expand on ideas
**Example:**
```
"Review this email and improve the clarity.
Keep the professional tone but make it more concise."
```
### Summarizing
Condense long content into key points:
* Summarize documents and articles
* Extract main ideas
* Create executive summaries
* Generate TL;DR versions
**Example:**
```
"Summarize this 20-page report into a one-page executive summary
highlighting the key findings and recommendations."
```
## Research & Analysis
### Information Retrieval
Get answers to questions:
* Explain concepts and terms
* Compare options and alternatives
* Provide background information
* Answer technical questions
**Example:**
```
"What are the main differences between microservices
and monolithic architecture? Include pros and cons of each."
```
### Data Analysis
Help with understanding data:
* Identify patterns and trends
* Explain what data means
* Suggest insights
* Create interpretations
**Example:**
```
"Here's our monthly sales data [attachment].
What trends do you see and what might be causing the Q3 dip?"
```
### Competitive Research
Gather competitive intelligence:
* Compare features and capabilities
* Identify differentiators
* Research market positioning
* Analyze competitor content
**Example:**
```
"Based on our product features, what would be our key
differentiators compared to competitors like X and Y?"
```
## Tasks & Productivity
### Task Creation
AI coworkers can create tasks from conversations:
```
"Create a task to review the Q3 marketing budget.
Set it as high priority with a due date of next Friday."
```
### Task Management
AI can help manage your tasks:
* Suggest task breakdowns
* Recommend priorities
* Identify dependencies
* Create project plans
**Example:**
```
"I need to launch a new feature by March 1st.
Help me break this down into tasks and milestones."
```
### Meeting Preparation
Get ready for meetings:
* Create agendas
* Draft talking points
* Prepare questions
* Summarize background information
**Example:**
```
"I have a client meeting tomorrow about their mobile app project.
Create an agenda and list of discussion points based on
their requirements document [attachment]."
```
## Creative & Brainstorming
### Idea Generation
Generate ideas and options:
* Brainstorm solutions to problems
* Generate name ideas
* Create taglines and slogans
* Explore different approaches
**Example:**
```
"Brainstorm 10 names for our new project management feature.
It helps teams track progress visually."
```
### Problem Solving
Work through challenges:
* Analyze problems from multiple angles
* Suggest potential solutions
* Identify risks and considerations
* Evaluate trade-offs
**Example:**
```
"Our user onboarding completion rate is only 40%.
What might be causing this and how could we improve it?"
```
## Technical Assistance
### Code Help
Get programming assistance:
* Explain code concepts
* Debug issues
* Suggest implementations
* Review code logic
**Example:**
```
"How would I implement pagination in a REST API using Node.js?
Show me a basic example with query parameters."
```
### Technical Writing
Create technical content:
* Documentation
* API descriptions
* Technical specifications
* How-to guides
**Example:**
```
"Write API documentation for an endpoint that creates a new user.
Include request/response examples and error codes."
```
## Image Generation
### Creating Images
Some AI coworkers can generate images:
* Illustrations and graphics
* Concept visualizations
* Social media images
* Simple designs
**Example:**
```
"Generate an illustration of a team collaborating around
a virtual whiteboard, in a modern flat design style."
```
Image generation capabilities depend on which AI coworkers are configured in your workspace.
## Specialized Skills
### By AI Coworker Type
Different AI coworkers have different strengths:
| Coworker | Best For |
| ----------------------- | ------------------------------------------ |
| **Writing Assistant** | Content creation, editing, tone adjustment |
| **Research Assistant** | Finding information, analysis, comparisons |
| **Productivity Helper** | Task management, planning, organization |
| **Software Assistant** | Code help, technical questions, debugging |
| **Creative Assistant** | Brainstorming, creative writing, ideation |
### Choosing the Right Coworker
Select based on your need:
* Writing tasks → Writing Assistant
* Technical questions → Software Assistant
* Project planning → Productivity Helper
* Creative work → Creative Assistant
## Capabilities by Context
### In Chat
* Real-time conversation
* Multi-turn discussions
* File analysis
* Content generation
### With Tasks
* Task creation
* Assignment (AI as assignee)
* Task updates
* Progress tracking
### With Knowledge Base
* Document summarization
* Content suggestions
* Q\&A about resources
* Draft creation
## Limitations
### What AI Coworkers Can't Do
Be aware of limitations:
* **No real-time internet access**: Can't browse live websites
* **Knowledge cutoffs**: Information has a training date
* **Subjective judgment**: May not understand nuanced context
* **Verification needed**: Outputs should be reviewed
* **No system access**: Can't access your files directly (unless attached)
### When to Use Human Judgment
* Final decisions on strategy
* Sensitive communications
* Legal or compliance matters
* Complex interpersonal situations
* Critical business decisions
## Getting Better Results
### Tips for Better Outputs
Show examples of what you want. "Write it like this example: \[example]"
Tell the AI how to structure output. "Use bullet points" or "Create a table"
Add limits. "Keep it under 200 words" or "Use simple language"
Specify who will read it. "This is for technical developers" or "For executive stakeholders"
Refine through conversation. "Make it more formal" or "Add more detail to section 2"
### Quality Review
Always review AI outputs:
* Check factual accuracy
* Verify tone is appropriate
* Ensure completeness
* Confirm it meets your needs
* Add personal touches
## Next Steps
Create AI coworkers tailored to your needs.
Master AI conversation techniques.
# Chatting with AI
Source: https://docs.trilo.chat/ai-coworkers/chatting-with-ai
How to have effective conversations with AI coworkers
AI coworkers are designed to understand natural language and help with a wide range of tasks. This guide will help you communicate effectively to get the best results.
## Starting a Conversation
### Opening a Chat
Click on an AI coworker in the sidebar or Direct Messages.
Enter your question or request in the message box.
Press Enter to send your message.
The AI processes your message and responds in real-time.
### First Messages
Good opening messages:
* State what you need help with
* Include relevant context
* Be specific about the desired outcome
**Examples:**
```
"I need help writing a project proposal for a new mobile app feature"
"Can you explain how API rate limiting works?"
"Help me brainstorm marketing ideas for our product launch"
```
## Effective Communication
### Be Specific
Vague requests get vague answers. Be specific about what you need.
**Less effective:**
```
"Help with the email"
```
**More effective:**
```
"Help me write a professional email to a client explaining that their
project will be delayed by two weeks due to technical issues. The tone
should be apologetic but confident about the new timeline."
```
### Provide Context
The more relevant information you share, the better the response.
**Include when helpful:**
* Background on the situation
* Your goals or objectives
* Constraints or requirements
* Target audience
* Tone or style preferences
**Example:**
```
"I'm preparing a presentation for our executive team about Q3 results.
They prefer concise bullet points with key metrics highlighted.
Our main achievement was 40% revenue growth. Can you help me
structure the presentation outline?"
```
### Be Direct
State exactly what you want the AI to do.
**Less effective:**
```
"I was thinking maybe the document could be better?"
```
**More effective:**
```
"Please review this document and:
1. Fix any grammar errors
2. Improve the clarity of the introduction
3. Add a stronger conclusion"
```
## Conversation Flow
### Building on Previous Messages
AI coworkers remember the conversation context. Build on previous messages:
```
You: Can you summarize this article? [attachment]
AI: Here are the main points from the article...
You: Now create a tweet thread from those points
AI: Here's a thread with 5 tweets covering the key ideas...
You: Make the second tweet more engaging
AI: Here's a revised version of tweet #2...
```
### Asking Follow-Up Questions
Continue the conversation naturally:
```
You: What are best practices for user authentication?
AI: Here are key best practices: [explanation]
You: Can you explain point 3 in more detail?
AI: Of course! Point 3 is about... [detailed explanation]
You: How would I implement that in Node.js?
AI: Here's how you would implement it... [code example]
```
### Redirecting
If the conversation goes off track:
```
You: Actually, let's go back to the original topic.
Can you focus on the security aspects?
AI: Of course! Let me refocus on security...
```
## Giving Feedback
### When Output Is Good
Confirm when you're happy:
```
You: Perfect, that's exactly what I needed!
```
### When Output Needs Changes
Be specific about what to change:
```
You: This is good, but can you:
- Make it shorter (about half the length)
- Use simpler language
- Add more concrete examples
```
### When Output Is Wrong
Correct misunderstandings:
```
You: That's not quite right. I meant [clarification].
Can you try again with this in mind?
```
## Types of Requests
### Questions
Ask for information or explanations:
```
"What is the difference between REST and GraphQL?"
"How do I calculate compound interest?"
"What are the best practices for code reviews?"
```
### Task Completion
Request specific work to be done:
```
"Write a product description for our new feature"
"Create a list of interview questions for a marketing manager role"
"Generate test cases for the login functionality"
```
### Analysis
Ask for analysis of information:
```
"Summarize the key points from this document"
"What are the pros and cons of this approach?"
"Identify potential issues with this proposal"
```
### Creative Help
Get creative assistance:
```
"Brainstorm names for our new product"
"Help me come up with a tagline for the campaign"
"Suggest alternative solutions to this problem"
```
### Editing
Request improvements to content:
```
"Make this email more professional"
"Simplify this explanation for a non-technical audience"
"Check this text for grammar and clarity"
```
## Using Attachments
### Sharing Files
Include files in your conversation:
1. Click the attachment icon
2. Upload your file (document, image, etc.)
3. Add your question or request
4. Send
**Example:**
```
[Attachment: quarterly_report.pdf]
"Can you summarize the key findings from this report?"
```
### What You Can Share
* Documents (PDF, Word, etc.)
* Spreadsheets
* Images
* Code files
* Text files
## Formatting Tips
### For Complex Requests
Use structure to clarify complex requests:
```
I need help with a marketing email. Here are the details:
**Product:** New project management feature
**Audience:** Existing customers
**Goal:** Announce the feature and drive adoption
**Tone:** Excited but professional
**Length:** About 300 words
**Include:** Feature benefits, how to access it, support contact
```
### For Multiple Items
Use lists when asking for multiple things:
```
Please review this proposal and:
1. Check for logical consistency
2. Identify any gaps in the argument
3. Suggest improvements to the structure
4. Note any unclear sections
```
## Conversation Best Practices
Begin with a straightforward request. If the response isn't perfect, provide feedback and iterate.
For unrelated topics, start a new conversation. This keeps context clear.
Copy important outputs to your knowledge base or documents for future reference.
Try different ways of asking. You'll learn what works best for different types of requests.
## Example Conversations
### Writing Help
```
You: I need to write a rejection email to a job candidate.
It should be kind but clear, and encourage them to apply
for future positions.
AI: Here's a draft rejection email:
Subject: Your Application to [Company Name]
Dear [Name],
Thank you for taking the time to interview for the
[Position] role at [Company Name]...
[continues with full email]
You: Good, but can you make the opening warmer?
AI: Here's a revised version with a warmer opening:
Dear [Name],
I really appreciate you sharing your experience and
enthusiasm with us during the interview process...
```
### Research
```
You: What are the main differences between PostgreSQL and MySQL
for a new web application project?
AI: Here's a comparison of PostgreSQL vs MySQL for web applications:
**PostgreSQL**
- Better for complex queries and large datasets
- Stronger JSON support
- More standards-compliant
...
**MySQL**
- Generally faster for simple read operations
- Easier to set up and manage
- Better hosting support
...
You: We'll have a lot of JSON data. Tell me more about
PostgreSQL's JSON support.
AI: PostgreSQL has excellent JSON capabilities...
```
## Troubleshooting
* Try rephrasing more simply
* Break complex requests into smaller parts
* Provide more context
* Give an example of what you want
* Specify desired length: "Keep it under 100 words"
* Ask for more detail: "Can you expand on this?"
* Request format: "Give me bullet points" or "Write a full paragraph"
* Specify the tone: "Make it more casual" or "Write formally"
* Give examples of the style you want
* Mention the audience: "This is for C-level executives"
## Next Steps
Explore everything AI coworkers can do.
Create specialized AI assistants.
# Custom AI Coworkers
Source: https://docs.trilo.chat/ai-coworkers/custom-coworkers
Create AI assistants tailored to your team's specific needs
While Trilo provides built-in AI coworkers, you can create custom AI coworkers that are specialized for your team's unique needs. Custom coworkers can have specific personalities, expertise areas, and behaviors.
## Why Create Custom Coworkers?
Custom AI coworkers let you:
* Match your brand voice and tone
* Specialize in your domain knowledge
* Create consistent responses for your use cases
* Define specific behaviors and constraints
* Build AI that understands your context
## Creating a Custom Coworker
### Getting Started
Navigate to the **AI Coworkers** section in settings.
Click **Create AI Coworker** or **+ New**.
Set up name, avatar, and description.
Write instructions for how the AI should behave.
Save your custom coworker. It's now available to your team.
### Basic Settings
#### Name
Choose a clear, memorable name:
* Reflects the coworker's purpose
* Easy to identify in lists
* Professional and appropriate
**Examples:**
* "Brand Voice Editor"
* "Customer Support Assistant"
* "Technical Documentation Helper"
#### Avatar
Set a visual identity:
* Upload a custom image
* Use generated avatars
* Choose colors that fit your brand
#### Description
Write a brief description that helps users understand:
* What this coworker does
* When to use it
* Its areas of expertise
**Example:**
```
Helps write customer-facing communications in our
brand voice. Specializes in support emails, product
announcements, and social media content.
```
## Defining Behavior
### Base Prompt
The base prompt tells the AI how to behave. This is the most important configuration.
**Structure your prompt to include:**
1. **Role definition**: Who is this AI?
2. **Expertise**: What does it know?
3. **Tone and style**: How should it communicate?
4. **Guidelines**: Rules it should follow
5. **Constraints**: What it should avoid
### Example Base Prompt
```
You are a Customer Support Assistant for Acme Corp.
**Role:** Help team members draft responses to customer
inquiries, ensuring consistent and helpful communication.
**Expertise:**
- Product knowledge for Acme's software suite
- Common customer issues and solutions
- Support best practices
**Tone:**
- Friendly and professional
- Empathetic to customer concerns
- Clear and concise
- Solution-oriented
**Guidelines:**
- Always acknowledge the customer's concern first
- Provide clear next steps
- Offer additional resources when relevant
- End with a helpful closing
**Avoid:**
- Technical jargon customers won't understand
- Blaming the customer
- Making promises we can't keep
- Sharing internal processes
```
### Writing Effective Prompts
Vague instructions lead to inconsistent results. Clearly state what you want.
Show the AI what good output looks like.
```
Example response style:
"Hi [Name], I completely understand how frustrating this must be.
Let me help you resolve this right away..."
```
Tell the AI what NOT to do as clearly as what to do.
After creating, test with real scenarios. Adjust the prompt based on results.
## Advanced Configuration
### Skills and Capabilities
Enable or configure specific capabilities:
| Capability | Description |
| --------------------- | ------------------------------------------ |
| **Task Creation** | Can create tasks from conversations |
| **Image Generation** | Can generate images (if available) |
| **Document Analysis** | Can process uploaded files |
| **Web Search** | Can search for information (if configured) |
### Temperature Setting
Control how creative vs. consistent the AI is:
* **Lower (0.1-0.3)**: More consistent, focused responses
* **Medium (0.5-0.7)**: Balanced creativity and consistency
* **Higher (0.8-1.0)**: More creative, varied responses
**When to adjust:**
* Support responses: Lower temperature for consistency
* Creative writing: Higher temperature for variety
* Technical answers: Lower temperature for accuracy
### Token Limits
Set maximum response length:
* Shorter limits for concise answers
* Longer limits for detailed content
* Balance between thoroughness and brevity
## Use Case Examples
### Customer Support Assistant
```
**Name:** Support Helper
**Description:** Drafts customer support responses
following our guidelines and tone.
**Base Prompt:**
You help draft customer support emails. Follow these principles:
- Always empathize first
- Provide clear solutions
- Use simple, jargon-free language
- Include relevant help center links
- Sign off warmly
Avoid: defensive language, technical terms,
acknowledging bugs not yet announced publicly.
```
### Content Editor
```
**Name:** Brand Voice Editor
**Description:** Reviews and edits content to match
our brand voice and style guide.
**Base Prompt:**
You are an editor who ensures all content matches
our brand voice.
Our voice is:
- Confident but not arrogant
- Friendly and approachable
- Clear and concise
- Optimistic and helpful
When reviewing content:
1. Check for brand voice alignment
2. Suggest specific improvements
3. Flag any issues
4. Provide the edited version
```
### Onboarding Guide
```
**Name:** Onboarding Buddy
**Description:** Helps new team members learn
our processes and tools.
**Base Prompt:**
You help new team members get up to speed.
You're friendly, patient, and thorough.
Knowledge areas:
- Company tools and how to use them
- Team processes and workflows
- Where to find documentation
- Who to ask for what
Always:
- Welcome questions, no matter how basic
- Point to relevant resources
- Suggest logical next steps
- Encourage asking follow-up questions
```
## Managing Custom Coworkers
### Editing
To update a custom coworker:
1. Go to AI Coworkers in settings
2. Find your custom coworker
3. Click **Edit**
4. Make changes
5. Save
Changes apply to new conversations.
### Duplicating
Create variations based on existing coworkers:
1. Find the coworker to copy
2. Click **Duplicate**
3. Modify as needed
4. Save with a new name
### Deleting
Remove coworkers no longer needed:
1. Find the coworker
2. Click **Delete**
3. Confirm deletion
Deleting a custom coworker removes it permanently. Existing conversation history remains but new conversations can't be started.
## Sharing Custom Coworkers
### Workspace Availability
Custom coworkers can be available to:
* **Entire workspace**: Everyone can use it
* **Specific projects**: Only in certain projects
* **Specific roles**: Only certain team members
### Permissions
Control who can:
* **Use**: Start conversations with the coworker
* **Edit**: Modify the coworker's configuration
* **Delete**: Remove the coworker
## Best Practices
Begin with a basic configuration. Add complexity as you learn what works.
Before rolling out, test with various scenarios to ensure consistent behavior.
Ask team members how well the coworker performs. Use feedback to improve.
Write clear descriptions so team members know when to use each coworker.
Review and update coworkers as your needs evolve. Outdated prompts give outdated results.
## Troubleshooting
* Make instructions more explicit
* Add examples of correct behavior
* Remove conflicting guidelines
* Test with the prompt to refine
* Lower the temperature setting
* Be more specific in the prompt
* Add constraints and boundaries
* Include more examples
* Add instruction: "Be concise"
* Set lower token limits
* Specify desired response length
* Include examples of ideal length
## Next Steps
Explore what AI coworkers can do.
Learn effective AI communication.
# AI Coworkers Overview
Source: https://docs.trilo.chat/ai-coworkers/overview
Work alongside intelligent AI assistants that help you get more done
AI Coworkers are intelligent assistants built into Trilo that can help you with a wide range of tasks. From drafting content to analyzing data, these AI team members are ready to assist whenever you need them.
## What Are AI Coworkers?
AI Coworkers are AI-powered assistants that:
* Chat with you in real-time
* Help with writing, research, and analysis
* Create and update tasks
* Generate content and summaries
* Run multi-step workflows automatically
* Work alongside human team members
Think of them as always-available team members with specialized skills.
## Types of AI Coworkers
### Global AI Coworkers
Pre-built assistants available to everyone:
| Coworker | Specialization |
| ----------------------- | --------------------------------------- |
| **Writing Assistant** | Content creation, editing, proofreading |
| **Research Assistant** | Finding information, summarizing |
| **Productivity Helper** | Task management, organization |
| **Software Assistant** | Code help, technical questions |
| **Creative Assistant** | Brainstorming, creative writing |
### Custom AI Coworkers
Create AI coworkers tailored to your needs:
* Define custom personalities and behaviors
* Set specific areas of expertise
* Configure for your team's workflows
* Match your brand voice
Learn how to build your own AI coworkers.
## Key Features
### Real-Time Conversations
Chat naturally with AI coworkers:
* Ask questions and get instant answers
* Have back-and-forth discussions
* Build on previous context
* Get help whenever you need it
### Task Integration
AI coworkers can work with your tasks:
* Create tasks from conversations
* Update task statuses
* Be assigned as task owners
* Report on task progress
### Content Generation
Get help creating content:
* Draft documents and messages
* Generate ideas and outlines
* Edit and improve existing content
* Translate between languages
### Analysis & Insights
Use AI for analysis:
* Summarize long documents
* Analyze data and trends
* Extract key information
* Answer questions about content
## Accessing AI Coworkers
### From the Sidebar
1. Click **AI Coworkers** in the navigation
2. See the list of available coworkers
3. Click one to start a conversation
### From Direct Messages
1. Go to Direct Messages
2. Select an AI coworker
3. Start chatting
### In Tasks
1. When assigning a task
2. AI coworkers appear as assignee options
3. Select one to assign work to AI
## AI Coworker Interactions
### Asking Questions
Get answers and information:
```
You: What's the best practice for database indexing?
AI: Database indexing improves query performance...
```
### Requesting Help
Ask for assistance with work:
```
You: Can you help me draft an email to the client about the project delay?
AI: Of course! I'd be happy to help. What details should I include?
```
### Giving Instructions
Direct the AI to complete tasks:
```
You: Create a summary of this document [attachment]
AI: Here's a summary of the key points...
```
### Following Up
Continue the conversation:
```
You: Make it more concise
AI: Here's a shorter version...
```
## What AI Coworkers Can Do
Draft emails, documents, messages. Edit for clarity and tone.
Find information, answer questions, explain concepts.
Summarize documents, extract insights, process data.
Generate ideas, brainstorm solutions, creative writing.
## AI Transparency
### Know When AI Is Working
Trilo clearly indicates AI involvement:
* AI-generated content is labeled
* Task activity shows AI actions
* You always know what was created by AI vs. humans
### Review AI Work
AI coworkers help, but you're in control:
* Review AI-generated content before using
* Edit and refine as needed
* Approve AI task completions
## Getting Started
Browse the AI Coworkers section in the sidebar.
Click a coworker and type your first message.
Try different types of requests to learn what they can do.
Start using AI assistance in your daily work.
## Best Practices
Clear, detailed requests get better results. Tell the AI exactly what you need.
Include relevant background information. The more context, the better the output.
If the first response isn't perfect, ask for changes. AI coworkers learn from feedback.
Always review AI-generated content before using it. Verify accuracy and appropriateness.
## Next steps
Learn how to have effective AI conversations.
Build automated multi-step AI agents.
Discover everything AI coworkers can do.
Create your own AI assistants.
# Workflows
Source: https://docs.trilo.chat/ai-coworkers/workflows
Build AI-powered automations that run multi-step tasks on your behalf
Workflows let you create AI agents that handle complex, multi-step work automatically. Define what you want done, add the tools and context the AI needs, and let it run—on a schedule or whenever you trigger it.
## What can workflows do?
A workflow is basically an instruction manual for an AI coworker. You describe the goal, list the steps, and the AI figures out how to execute each one. Some examples:
* **Weekly reports**: Pull data from connected apps, summarize it, post to a project channel
* **Content pipelines**: Research a topic, draft an article, create social posts
* **Customer follow-ups**: Check for new support tickets, draft responses, flag urgent ones
* **Code reviews**: Scan recent commits, note potential issues, create tasks for fixes
The AI can use any tools you've connected—GitHub, Gmail, Slack, Shopify, and dozens more.
## Creating a workflow
In any project's Resources section, click **+ New** and select **Workflow**.
Describe what you want the workflow to accomplish. Be specific—the clearer you are, the better the results.
List the steps as a numbered list. Each step should be a single action the AI can complete.
If your workflow needs external tools (GitHub, email, etc.), add them from the configuration panel.
Include any pages, files, or background info the AI should reference while working.
## Anatomy of a workflow
A workflow page has three main parts:
### Configuration block
At the top of the page, you'll see settings for:
| Setting | What it controls |
| ---------------- | ------------------------------------------------------------------ |
| **AI model** | Which AI model runs the workflow (affects speed and quality) |
| **Schedule** | When to run automatically (manual, hourly, daily, weekly, monthly) |
| **Integrations** | Which connected apps the workflow can use |
### Goal section
A plain-language description of what the workflow should accomplish. Write this like you're explaining the task to a new team member.
**Good goal:**
> Check our GitHub repository for any open PRs older than 3 days. For each one, post a reminder in the #dev channel asking the author to address it or close it.
**Vague goal:**
> Help with GitHub PRs.
### Steps section
A numbered list of actions. Each step should be:
* **Specific**: One clear action
* **Achievable**: Something the AI can actually do with available tools
* **Sequential**: Order matters—later steps can depend on earlier ones
```markdown theme={null}
1. Fetch all open pull requests from the main repository
2. Filter to PRs that have been open more than 3 days
3. For each PR, look up the author's Slack handle
4. Post a message in #dev tagging the author with a link to their PR
5. Create a summary of all PRs you messaged about
```
## Running workflows
### Manual runs
Click the **Run** button in the workflow header to start immediately. You'll see real-time progress as the AI works through each step.
### Scheduled runs
Set a schedule in the configuration block:
| Schedule | When it runs |
| ----------- | ------------------------------------------- |
| **Hourly** | Every hour on the hour |
| **Daily** | Once per day (you pick the time) |
| **Weekly** | Once per week (you pick the day and time) |
| **Monthly** | Once per month (you pick the date and time) |
Scheduled workflows run automatically. You'll see results in the workflow's run history.
## Watching a workflow run
When a workflow executes, you can watch it in real time:
* **Step timeline**: See which step is currently running
* **Tool calls**: Watch the AI interact with connected apps
* **Progress indicators**: Track completion percentage
* **Token usage**: Monitor how much AI capacity the run uses
The AI shows its work—you can see exactly what it's doing at each step.
## Review gates
Sometimes you don't want the AI to barrel through every step without checking in. Add review gates to pause execution and wait for your approval.
### How review gates work
1. The workflow runs until it hits a review gate
2. Execution pauses and you get a notification
3. You review what the AI has done so far
4. Choose to **approve** (continue), **reject** (stop), or **regenerate** (try again with feedback)
### When to use review gates
* Before sending external communications
* Before making changes that are hard to undo
* When the AI needs to make judgment calls
* For high-stakes steps where you want human oversight
Review gates are optional. Simple, low-risk workflows often don't need them.
## Workflow results
After a workflow completes, you get:
* **Output summary**: What the workflow accomplished
* **Tool call log**: Every action taken, with parameters and results
* **Resources created**: Any tasks, pages, or other items the workflow made
* **Run duration**: How long execution took
* **Token usage**: AI capacity consumed
All runs are saved in the workflow's history, so you can review past executions anytime.
## Integrations in workflows
Workflows become much more powerful when connected to external tools. When you add an integration, the AI can:
| Integration | What workflows can do |
| ----------- | ---------------------------------------------------- |
| **GitHub** | Read/create issues, PRs, comments, check repo status |
| **Gmail** | Send emails, search inbox, draft replies |
| **Slack** | Post messages, read channels, send DMs |
| **Linear** | Create/update issues, manage projects |
| **Shopify** | Check orders, update products, manage inventory |
Connect apps to enable them in workflows.
## What workflows create
Workflows can generate resources as they run:
* **Tasks**: Create task records for follow-up work
* **Pages**: Generate documents with findings or reports
* **Messages**: Post updates to project channels
* **Calendar events**: Schedule meetings or reminders
These show up in your workspace like any other resource, tagged with which workflow created them.
## Troubleshooting workflows
Check the error message in the run log. Common causes:
* Missing integration permissions
* API rate limits on connected services
* Step instructions that are unclear or impossible
Try rephrasing the step or checking your integration connections.
The AI interprets your instructions, so vague goals lead to unpredictable results. Review your goal and steps:
* Is each step specific enough?
* Did you provide enough context?
* Are there edge cases you didn't account for?
Complex workflows with many steps take time. To speed things up:
* Combine steps that can be done together
* Use a faster AI model for simple tasks
* Remove unnecessary steps
Check that:
* The schedule is set correctly in configuration
* The workflow isn't paused
* There are no integration connection issues
## Tips for better workflows
Build a basic version first and make sure it works. Add complexity gradually—it's easier to debug a simple workflow than a complex one.
"Check GitHub for issues" is vague. "Fetch open issues labeled 'bug' from the acme/api repository" is specific.
Run the workflow manually a few times before setting up automated scheduling. Make sure it behaves the way you expect.
Any step that sends external communications or makes permanent changes should probably have a review gate.
The more relevant context you provide (pages, examples, background info), the better the AI can execute your instructions.
## Next steps
See everything AI coworkers can do.
Connect external apps for workflows.
# Booking Pages
Source: https://docs.trilo.chat/calendar/booking
Let others schedule time with you through public booking links
Booking pages allow external people to schedule meetings with you without the back-and-forth of finding a time. Share your booking link and let others pick a time that works for both of you.
## How Booking Works
1. **You set up** your booking page with available times
2. **You share** the booking link with others
3. **They choose** a time from your available slots
4. **Both calendars** update with the meeting
## Setting Up Your Booking Page
### Quick access from calendar
The fastest way to manage your booking page is from the calendar header:
1. Open your **Calendar**
2. Look for your booking URL in the header area
3. Click to copy, enable/disable, or open settings
### Full settings
For complete configuration:
Click the booking URL in your calendar header, then **Edit settings**. Or go to **Settings > Booking**.
Toggle on your public booking page.
Set up your availability and preferences.
### Basic Settings
Configure your booking page essentials:
| Setting | Description |
| ---------------- | ---------------------------------------- |
| **Display name** | The name shown on your booking page |
| **Bio** | Brief description about you or your role |
| **Booking link** | Your unique URL (customizable) |
| **Timezone** | Your default timezone for availability |
## Availability Settings
### Working Hours
Set when you're available for bookings:
Select which days of the week you accept bookings.
For each day, set start and end times.
Optionally exclude lunch or other regular breaks.
**Example configuration:**
* Monday-Friday: 9:00 AM - 5:00 PM
* Lunch break: 12:00 PM - 1:00 PM
* Weekends: Unavailable
### Buffer Time
Add padding around meetings:
| Buffer Type | Purpose |
| ----------- | ------------------------------------------ |
| **Before** | Time before meetings (preparation) |
| **After** | Time after meetings (notes, decompression) |
**Example:**
* 15 minutes before each meeting
* 10 minutes after each meeting
This prevents back-to-back scheduling.
### Minimum Notice
Set how far in advance bookings must be made:
* **1 hour**: Same-day bookings allowed
* **24 hours**: Next-day minimum
* **48 hours**: Two-day advance notice
* **1 week**: Week-ahead planning
### Maximum Advance
Limit how far ahead people can book:
* **1 week**: Only near-term availability
* **2 weeks**: Short-term scheduling
* **1 month**: Standard advance booking
* **3 months**: Long-term availability
## Meeting Types
Create different booking options:
### Default Meeting
Your standard meeting type:
* Default duration (e.g., 30 minutes)
* General purpose
### Custom Meeting Types
Create specialized options:
**Examples:**
* **Quick Chat** - 15 minutes
* **Standard Meeting** - 30 minutes
* **Deep Dive** - 60 minutes
* **Consultation** - 45 minutes
### Meeting Type Settings
For each type, configure:
| Setting | Description |
| --------------- | -------------------------------- |
| **Name** | What the meeting is called |
| **Duration** | How long the meeting lasts |
| **Description** | What the meeting is for |
| **Location** | Default location or meeting link |
## Sharing Your Booking Link
### Your Booking URL
Your booking page has a unique URL:
```
trilo.chat/book/your-username
```
Or with a custom slug:
```
trilo.chat/book/your-company
```
### Where to Share
* Email signature
* Website "Schedule a meeting" link
* Social media profiles
* Email responses when scheduling
### Multiple Links
Share specific meeting types directly:
```
trilo.chat/book/your-username/quick-chat
trilo.chat/book/your-username/consultation
```
## When Someone Books
### Booking Flow
What the other person experiences:
1. Opens your booking link
2. Sees your available times
3. Selects a time slot
4. Enters their details (name, email)
5. Confirms the booking
### Confirmation
After booking:
* **They receive**: Confirmation email with meeting details and video link
* **You receive**: Notification of new booking
* **Calendar**: Event added to both calendars
* **Video meeting**: A meeting link is automatically created
The confirmation email includes:
* Meeting time in the guest's timezone
* A link to join the video call
* A cancellation link (more on this below)
### Calendar Sync
Booked meetings:
* Appear on your Trilo calendar
* Sync to connected calendars (Google, Outlook)
* Block the time from future bookings
### Video meetings
Every booking automatically gets a video meeting link. Guests can join directly from their confirmation email or calendar invite—no extra setup needed.
## Managing Bookings
### Booking dashboard
See all your bookings in one place:
1. Open **Booking Settings**
2. Click the **Bookings** tab
3. View upcoming and past bookings with status
Each booking shows:
* Guest name and contact info
* Scheduled time
* Status (confirmed, cancelled, completed, no-show)
### Viewing in calendar
Booked meetings also appear on your calendar like any other event. Click to see details or join the video call.
### Rescheduling
If you need to reschedule:
1. Open the booking
2. Click **Reschedule**
3. Select a new time
4. The booker is notified of the change
### Canceling
**You cancel:**
1. Open the booking
2. Click **Cancel**
3. Optionally add a reason
4. The guest receives cancellation notice
**Guest cancels:**
Guests can cancel using the link in their confirmation email. They'll see a page confirming the cancellation, and you'll be notified.
Cancellations notify both parties by email. Neither side is left wondering what happened.
## Booking Page Customization
### Appearance
Customize how your booking page looks:
* **Profile photo**: Your image or company logo
* **Colors**: Match your brand
* **Welcome message**: Custom greeting text
### Questions
Collect information from bookers:
* **Name**: Always required
* **Email**: Always required
* **Custom questions**: Add your own
**Example custom questions:**
* "What would you like to discuss?"
* "Company name"
* "Phone number (optional)"
## Blocking Time
### Manual Blocks
Block time when you're unavailable:
1. Create an event on your calendar
2. Mark it as "Busy" or "Out of office"
3. That time won't appear as available for booking
### Calendar Integration
Connected calendars affect availability:
* Events from Google/Outlook block booking slots
* This prevents double-booking
* Keep connected calendars up to date
## Limits and Controls
### Daily Limits
Control how many meetings can be booked:
* **Max bookings per day**: Limit daily meetings (e.g., 5)
* Prevents overwhelm on busy days
### Date-Specific Rules
Customize specific dates:
* Block holidays
* Add extra availability for specific days
* Override regular hours temporarily
## Best Practices
Don't make every hour available. Leave time for focused work, breaks, and unexpected needs.
Back-to-back meetings are exhausting. Add buffers to maintain energy and handle overruns.
Connect external calendars to ensure availability is accurate and you don't get double-booked.
Different purposes need different durations. Offer options so bookers choose appropriately.
A personalized booking page feels professional. Add your photo and a friendly bio.
## Troubleshooting
* Check your working hours are set correctly
* Verify your calendar isn't fully blocked
* Check minimum notice period
* Ensure booking page is enabled
* Connect your external calendars
* Ensure sync is working
* Check buffer times
* Review calendar for conflicts
* Verify their email was entered correctly
* Check spam/junk folders
* Try resending the confirmation
## Next Steps
Connect external calendars for availability sync.
Learn more about managing calendar events.
# Events
Source: https://docs.trilo.chat/calendar/events
Create and manage calendar events for meetings, appointments, and more
Events are the building blocks of your Trilo calendar. Whether you're scheduling a team meeting, setting a reminder, or marking a deadline, this guide covers everything you need to know.
## Creating Events
### Quick Create
The fastest way to create an event:
Click any empty time slot in week or day view.
Type the event name.
The event is created with default duration.
### Detailed Create
For events that need more information:
Click the new event button or press `C`.
Add all the information for your event.
Invite team members who should attend.
Configure when you want to be notified.
Click Save to create the event.
## Event Properties
### Title
Give your event a clear, descriptive name:
**Good examples:**
* "Weekly Team Standup"
* "1:1 with Sarah - Q1 Goals"
* "Product Demo for Client X"
* "Review PR #142"
### Date and Time
Set when the event occurs:
* **Start date**: When the event begins
* **Start time**: Specific start time
* **End time**: When the event concludes
* **All day**: Toggle for day-long events
### Timezone
Events respect timezones:
* Your timezone is set in your profile
* Events display in your local time
* When inviting others, times adjust automatically
### Event Type
Choose the category that best fits:
| Type | Icon | Best For |
| --------------- | -------- | --------------------------------- |
| **Meeting** | Video | Team syncs, calls, one-on-ones |
| **Appointment** | Calendar | Scheduled blocks, client meetings |
| **Reminder** | Bell | Follow-ups, personal reminders |
| **Deadline** | Flag | Due dates, submission deadlines |
| **Other** | Circle | Everything else |
### Priority
Set the importance level:
* **Low**: Optional, can be rescheduled
* **Medium**: Standard importance
* **High**: Important, try not to miss
### Location
Specify where the event takes place:
#### Physical Location
* Conference room name
* Office address
* External venue
#### Virtual Location
* Meeting link (Zoom, Google Meet, etc.)
* Phone number
* Other virtual platform
When you add a meeting link, Trilo displays a **Join** button on the event for easy access.
### Description
Add context and details:
* Agenda items
* Preparation notes
* Reference links
* Meeting objectives
The description supports markdown formatting for lists, links, and basic formatting.
## Participants
### Adding Participants
1. Click the **Participants** field
2. Search for team members by name
3. Click to add them
4. Repeat for all attendees
### Participant Status
Participants can respond to invitations:
| Status | Meaning |
| --------------- | --------------------- |
| **Accepted** | Will attend |
| **Declined** | Cannot attend |
| **Tentative** | Might attend |
| **No response** | Haven't responded yet |
### Managing Participants
* View attendee list on the event
* See response status for each person
* Remove participants if needed
* Add new participants anytime
## Reminders
Get notified before events start:
### Setting Reminders
1. Click **Add reminder** on the event
2. Choose when to be reminded:
* 5 minutes before
* 15 minutes before
* 30 minutes before
* 1 hour before
* 1 day before
* Custom time
### Multiple Reminders
Add multiple reminders for important events:
* 1 day before (preparation)
* 1 hour before (final check)
* 15 minutes before (get ready)
### Reminder Delivery
Reminders appear as:
* In-app notifications
* Browser notifications (if enabled)
* Email (if configured)
## Editing Events
### Quick Edit
* Click an event to open it
* Edit any field directly
* Changes save automatically
### Changing Time
**Drag and drop:**
* Click and hold the event
* Drag to a new time slot
* Release to reschedule
**Resize duration:**
* Hover over the bottom edge
* Drag to extend or shorten
### Editing Details
1. Click the event to open details
2. Click on any field to edit
3. Make your changes
4. Click Save or click away to save
## Deleting Events
### Delete a Single Event
1. Open the event
2. Click **...** menu
3. Select **Delete**
4. Confirm deletion
### Delete from Recurring Series
When deleting a recurring event, choose:
* **This event only**: Just this occurrence
* **All events**: The entire series
Deleted events cannot be recovered. If you're unsure, consider changing the event instead of deleting it.
## Event Visibility
### Workspace Events
Events visible to your workspace:
* Appear on the shared calendar
* Team members can see them
* Good for team meetings and milestones
### Private Events
Personal events only you can see:
* Personal reminders
* External appointments
* Private time blocks
## Best Practices
Include key information in the title so it's clear at a glance. "Team sync" is okay, "Weekly Marketing Team Sync" is better.
Even for virtual meetings, add the meeting link. It makes joining easy and prevents confusion.
Important meetings warrant multiple reminders. Quick check-ins might only need one.
Use the description to list what will be covered. This helps everyone come prepared.
Only invite people who need to attend. Others can be informed separately.
## Troubleshooting
* Check your timezone settings in your profile
* Verify the event was created in the correct timezone
* Refresh the calendar view
* Verify they're members of your workspace
* Check their notification settings
* Re-add them to the event
* You may not have edit permissions
* The event might be synced from an external calendar
* Check if it's a recurring event (may need to edit the series)
## Next Steps
Set up events that repeat automatically.
Connect external calendars.
# Calendar Integrations
Source: https://docs.trilo.chat/calendar/integrations
Connect Google Calendar, Outlook, and other calendars to Trilo
Trilo integrates with your existing calendars so you can see all your events in one place. Sync with Google Calendar, Outlook, and other calendar services for a unified scheduling experience.
## Supported Integrations
Two-way sync with Google Calendar for personal and work accounts.
Connect Microsoft Outlook for Office 365 integration.
## Google Calendar Integration
### Connecting Google Calendar
Click **Settings** in the sidebar.
Click on **Integrations** or **Calendar**.
Find the Google Calendar option and click **Connect**.
You'll be redirected to Google. Sign in with your Google account.
Allow Trilo to access your calendar. Review the permissions and click **Allow**.
Choose which Google calendars to sync with Trilo.
### What Syncs
With Google Calendar connected:
| Direction | What Syncs |
| ------------------ | ----------------------------------------------------- |
| **Google → Trilo** | Events from selected Google calendars appear in Trilo |
| **Trilo → Google** | Events created in Trilo can appear in Google Calendar |
### Managing Google Calendars
After connecting, you can:
* **Select calendars**: Choose which Google calendars to show
* **Toggle visibility**: Show or hide specific calendars
* **Set default**: Choose which calendar new events go to
### Disconnecting
To remove the Google Calendar integration:
1. Go to **Settings > Integrations**
2. Find Google Calendar
3. Click **Disconnect**
4. Confirm the disconnection
Disconnecting removes synced events from Trilo but doesn't affect your Google Calendar.
## Outlook Calendar Integration
### Connecting Outlook
Click **Settings** in the sidebar.
Navigate to the integrations section.
Find Outlook Calendar and click **Connect**.
Enter your Microsoft account credentials.
Allow Trilo to access your calendar data.
Select which calendars to sync.
### Outlook Sync Features
* View Outlook events in Trilo
* See availability from Outlook
* Create events that sync both ways
* Support for Office 365 accounts
## How Sync Works
### Sync Frequency
Calendar syncs happen:
* **Automatically**: Every few minutes
* **On action**: When you open the calendar
* **Manual refresh**: Click refresh to sync immediately
### Conflict Handling
When the same event exists in multiple places:
* Events are matched by unique identifiers
* Changes in source calendar take priority
* Deleted events are removed from sync
### Event Details
Synced events include:
* Title
* Date and time
* Duration
* Location
* Description (if permitted)
Private or confidential events may sync with limited details based on your privacy settings in the source calendar.
## Viewing Synced Events
### Identifying Synced Events
Synced events are marked with:
* Source calendar indicator
* Integration icon (Google, Outlook)
* Different color coding (optional)
### Editing Synced Events
Depending on configuration:
* **Some events**: Edit in Trilo, changes sync back
* **Some events**: View-only in Trilo, edit in source calendar
* **New events**: Can be created in either system
## Multiple Calendars
### Managing Multiple Sources
You can connect:
* Multiple Google accounts
* Multiple Outlook accounts
* Mix of different calendar services
### Calendar Colors
Assign colors to different calendars:
* Personal calendar: Blue
* Work calendar: Green
* Team calendar: Purple
This helps distinguish events at a glance.
### Toggling Visibility
Show or hide calendars:
1. Open calendar settings
2. Toggle visibility for each calendar
3. Hidden calendars don't display events
## Troubleshooting
* Check your internet connection
* Verify the calendar is selected for sync
* Try disconnecting and reconnecting
* Click refresh to force a sync
* Check timezone settings in Trilo
* Verify timezone in the source calendar
* Events should display in your local timezone
* Ensure pop-ups are allowed for authentication
* Try a different browser
* Check that you're using a supported calendar type
* Verify your account has calendar access enabled
* Some private events may not sync
* Check if the calendar is selected for sync
* Verify date range (very old events may not sync)
* Check if the event was deleted in the source
* Avoid creating the same event in multiple places
* Check if both Trilo and source calendar created it
* Delete the duplicate in the appropriate system
## Privacy Considerations
When connecting calendars:
* Trilo requests only necessary permissions
* Event data is stored securely
* You control which calendars sync
* Disconnect anytime to stop syncing
* Private events respect privacy settings
## Best Practices
Don't sync every calendar you have. Choose the ones you need to see in Trilo for work purposes.
Decide whether to create events in Trilo or your source calendar. Consistency prevents confusion.
Occasionally check that sync is working correctly. Look for missing or duplicate events.
In your source calendar, set events you want to share as public/free, and sensitive events as private.
## Other integrations
This page covers calendar sync—connecting Google Calendar and Outlook so you can see external events in Trilo.
For integrations that AI coworkers can use (GitHub, Gmail, Slack, Shopify, and more), see the full integrations guide.
Connect apps for AI coworkers and workflows.
## Next steps
Set up scheduling for external meetings.
Learn more about creating events.
# Calendar Overview
Source: https://docs.trilo.chat/calendar/overview
Schedule events, manage your time, and sync with external calendars
The Trilo Calendar helps you and your team stay organized with scheduling, event management, and calendar integrations. View your schedule, create events, and even set up booking pages for external meetings.
## Calendar Features
Create and manage one-time events, meetings, and appointments.
Set up events that repeat daily, weekly, monthly, or yearly.
Sync with Google Calendar and Outlook for unified scheduling.
Let others book time with you through public booking links.
## Calendar Views
### Month View
See your entire month at a glance:
* Overview of all events
* Click any day to see details
* Drag events to reschedule
* Color-coded by event type
### Week View
Focus on the current week:
* Detailed time slots
* See event duration
* Spot availability easily
* Good for scheduling meetings
### Day View
Detailed view of a single day:
* Hour-by-hour breakdown
* All event details visible
* Perfect for busy days
* Easy time management
## Event Types
Trilo supports different event types to help categorize your schedule:
| Type | Use For | Icon |
| --------------- | ------------------------------------- | ------------- |
| **Meeting** | Team syncs, one-on-ones, client calls | Video icon |
| **Appointment** | Scheduled time with specific people | Calendar icon |
| **Reminder** | Personal reminders and follow-ups | Bell icon |
| **Deadline** | Project deadlines and due dates | Flag icon |
| **Other** | Anything that doesn't fit above | Generic icon |
## Quick Actions
### Create an Event
1. Click on a time slot in the calendar
2. Or click **+ New Event** button
3. Fill in event details
4. Save
### Navigate
* **Today**: Click "Today" to jump to current date
* **Arrow navigation**: Move forward/backward in time
* **View toggle**: Switch between month/week/day views
### View Event Details
* Click any event to open its details
* See attendees, location, and description
* Edit or delete from the detail view
## Calendar Integration
Trilo connects with your existing calendars:
### Google Calendar
* Two-way sync with Google
* See all your events in one place
* Create events that appear in both
### Outlook Calendar
* Sync with Microsoft Outlook
* Unified scheduling experience
* Keep work and personal separate
Learn how to connect your external calendars.
## Workspace Calendar
Each workspace has a shared calendar where:
* Team events are visible to everyone
* Project milestones appear automatically
* You can see teammates' availability
* Scheduling conflicts are easy to spot
## Personal Calendar
Your personal view shows:
* Events you're attending
* Your own events and reminders
* Synced events from connected calendars
* A unified view of all your commitments
## Event Properties
Every event can include:
| Property | Description |
| ---------------- | --------------------------------- |
| **Title** | Name of the event |
| **Date & Time** | When it occurs |
| **Duration** | How long it lasts |
| **Location** | Physical address or virtual link |
| **Description** | Additional details |
| **Participants** | Who's invited |
| **Event Type** | Meeting, reminder, deadline, etc. |
| **Priority** | Low, Medium, High |
| **Reminders** | When to be notified |
## Booking System
Let external people schedule time with you:
* Create a public booking page
* Set your available hours
* Define meeting types and durations
* Share the link for easy scheduling
Create your booking page.
## Keyboard Shortcuts
| Action | Shortcut |
| --------------- | -------- |
| New event | `C` |
| Today | `T` |
| Day view | `D` |
| Week view | `W` |
| Month view | `M` |
| Previous period | `←` |
| Next period | `→` |
## Getting Started
Click **Calendar** in the main navigation.
Select Month, Week, or Day view based on your needs.
Click a time slot or the **+ New Event** button.
Go to Settings to sync Google or Outlook calendars.
## Next Steps
Learn all the details about creating events.
Set up events that repeat on a schedule.
# Recurring Events
Source: https://docs.trilo.chat/calendar/recurring-events
Create events that automatically repeat on your schedule
Recurring events save time by automatically creating repeating events on your calendar. Perfect for regular meetings, weekly check-ins, and monthly reviews.
## Creating Recurring Events
Click **+ New Event** or click a time slot.
Add title, time, location, and participants.
Click **Does not repeat** to open recurrence options.
Select how often the event should repeat.
The recurring series is created.
## Recurrence Patterns
### Daily
Event repeats every day:
* **Every day**: Includes weekends
* **Every weekday**: Monday through Friday only
* **Every X days**: Custom interval (e.g., every 2 days)
**Best for:**
* Daily standups
* Daily check-ins
* Routine reviews
### Weekly
Event repeats on specific days each week:
* **Same day each week**: e.g., every Monday
* **Multiple days**: e.g., every Monday and Thursday
* **Every X weeks**: Custom interval (e.g., every other week)
**Best for:**
* Weekly team meetings
* Regular one-on-ones
* Sprint ceremonies
### Bi-Weekly
Event repeats every two weeks:
* Falls on the same day
* Skips alternate weeks
* Useful for less frequent check-ins
**Best for:**
* Bi-weekly sprints
* Alternating schedules
* Periodic reviews
### Monthly
Event repeats once a month:
* **Same date**: e.g., the 15th of each month
* **Same day**: e.g., first Monday of each month
* **Every X months**: Custom interval
**Best for:**
* Monthly reviews
* End-of-month deadlines
* Regular monthly meetings
### Yearly
Event repeats once a year:
* Same date each year
* Anniversary reminders
* Annual reviews
**Best for:**
* Birthdays
* Annual planning
* Yearly reviews
## Recurrence Options
### Start Date
When the recurring series begins:
* Defaults to the event date
* Can be set to a future date
### End Conditions
Choose when the series ends:
| Option | Description |
| ----------------------- | -------------------------------------- |
| **Never** | Events continue indefinitely |
| **After X occurrences** | Ends after a specific number of events |
| **On date** | Ends on a specific date |
For ongoing meetings, choose "Never" and delete the series when no longer needed. For limited-duration events (like a 6-week course), set a specific end date.
## Managing Recurring Events
### Editing Single Occurrences
Change just one event in the series:
Open the specific occurrence you want to change.
Edit time, location, participants, etc.
When prompted, select **This event only**.
Only this occurrence is changed.
### Editing the Entire Series
Change all events in the series:
Open any occurrence.
Edit the properties you want to change.
Select **All events** or **This and future events**.
Changes apply to selected events.
### Edit Options
When editing a recurring event:
| Option | Effect |
| -------------------------- | --------------------------------------- |
| **This event only** | Changes only this occurrence |
| **This and future events** | Changes this and all future occurrences |
| **All events** | Changes every event in the series |
### Deleting Occurrences
Remove individual events:
1. Open the event to delete
2. Click **Delete**
3. Choose **This event only**
4. The rest of the series continues
### Deleting the Series
Remove the entire recurring series:
1. Open any event in the series
2. Click **Delete**
3. Choose **All events**
4. Confirm deletion
Deleting a series removes all past and future occurrences. Consider deleting only future events if you want to preserve history.
## Exceptions
Sometimes you need to skip or modify specific occurrences.
### Skipping an Occurrence
To skip one event in a series (like a meeting on a holiday):
1. Open the specific occurrence
2. Click **Delete**
3. Choose **This event only**
4. The other events remain
### Rescheduling an Occurrence
Move just one event to a different time:
1. Open the specific occurrence
2. Change the date or time
3. Choose **This event only**
4. Save the change
The rest of the series continues as scheduled.
## Common Patterns
### Weekly Team Meeting
```
Title: Team Weekly Sync
Time: Monday 10:00 AM - 11:00 AM
Recurrence: Weekly on Monday
End: Never
```
### Bi-weekly One-on-One
```
Title: 1:1 with Manager
Time: Tuesday 2:00 PM - 2:30 PM
Recurrence: Every 2 weeks on Tuesday
End: Never
```
### Monthly Review
```
Title: Monthly Business Review
Time: First Friday 3:00 PM - 4:00 PM
Recurrence: Monthly on first Friday
End: Never
```
### Daily Standup (Weekdays)
```
Title: Daily Standup
Time: Every day 9:00 AM - 9:15 AM
Recurrence: Every weekday
End: Never
```
## Best Practices
Don't over-schedule. Too many recurring meetings can overwhelm calendars. Question whether every recurring meeting is necessary.
Periodically audit your recurring events. Cancel or adjust ones that are no longer useful.
It's fine to skip or reschedule individual occurrences. This keeps the series intact while accommodating real-world schedule changes.
Since recurring events happen often, make sure the description includes context for regular attendees and newcomers alike.
For teams across time zones, choose times that work reasonably for everyone, or rotate times periodically.
## Troubleshooting
When editing, make sure you select the correct scope (this event only, this and future, or all events).
* Check the start date is in the past or present
* Verify the recurrence pattern is correct
* Make sure it wasn't accidentally deleted
Past events may have limited editing options. You can typically only modify future occurrences.
## Next Steps
Sync recurring events with external calendars.
Set up scheduling for external meetings.
# Direct Messages
Source: https://docs.trilo.chat/chat/direct-messages
Private one-on-one conversations with team members and AI coworkers
Direct messages (DMs) let you have private conversations with individual team members or AI coworkers. Unlike project channels, DMs are visible only to the participants.
## Starting a Direct Message
### With a Team Member
Look in the sidebar under **Direct Messages** or **Team Members**.
A DM conversation opens.
Type your message and press Enter.
### With an AI Coworker
Click **AI Coworkers** in the sidebar.
Choose the AI coworker you want to chat with.
Ask questions or give instructions.
### From Anywhere
Quick-start a DM:
1. Click the **+** button or "New message"
2. Search for a person by name
3. Select them from the results
4. Start your conversation
## DM Features
### Private by Design
DMs are visible only to:
* You
* The other participant
No one else can see your direct messages—not even workspace admins.
### Message History
* Conversation history is preserved
* Scroll up to see past messages
* Search within the conversation
### All Message Features
DMs support everything project channels do:
* Rich text formatting
* File attachments
* Reactions
* Message editing and deletion
* Threads
## Chatting with AI Coworkers
### Starting an AI Conversation
1. Select an AI coworker from the list
2. Type your message or question
3. The AI responds in real-time
### AI Response Streaming
Watch AI responses appear as they're generated:
* Text streams in as it's written
* No waiting for complete response
* You can read while it's still generating
### AI Capabilities in DMs
Depending on the AI coworker, you can:
* Ask questions and get answers
* Request help with writing
* Get analysis and insights
* Delegate tasks
* Generate content
### Example AI Conversations
**Asking for help:**
```
You: Can you help me draft an email to a client about our project delay?
AI: Of course! I'd be happy to help. Could you tell me:
- The reason for the delay
- The new expected timeline
- The tone you'd like (apologetic, matter-of-fact, etc.)
```
**Getting information:**
```
You: What's the best practice for database indexing?
AI: Here are key best practices for database indexing...
```
**Delegating work:**
```
You: Please summarize the main points from this document [attachment]
AI: I've reviewed the document. Here are the main points...
```
## Managing Direct Messages
### Finding Conversations
Recent DMs appear in the sidebar:
* Most recent conversations at the top
* Unread indicators for new messages
* Search to find older conversations
### Starting Fresh
Each time you open a DM, the conversation continues where you left off. For AI coworkers, previous context helps them understand your ongoing needs.
### Clearing History
If needed, you can:
* Delete individual messages
* Start a new conversation thread
* Archive old conversations
## DM Notifications
### Notification Settings
Control how you're notified:
* **All messages**: Notify for every DM
* **Mentions only**: Just when you're mentioned
* **Nothing**: Mute the conversation
### Muting a Conversation
For busy conversations:
1. Open the DM
2. Click the settings icon
3. Select **Mute notifications**
4. Choose duration or permanent
### Unmuting
1. Go to the muted conversation
2. Click settings
3. Select **Unmute**
## Presence in DMs
### Online Status
See if the person is available:
* **Green dot**: Online and active
* **No indicator**: Offline or away
* **Typing...**: Currently composing
### Read Receipts
Know when your message is seen:
* "Delivered" when sent
* "Seen" when they've read it (if enabled)
## DM vs. Project Channels
| Use DMs For | Use Channels For |
| ------------------- | ------------------ |
| Private discussions | Project updates |
| Quick questions | Team decisions |
| Personal matters | Shared information |
| One-on-one feedback | Group discussions |
| AI conversations | Project context |
## AI Coworker DM Tips
### Be Specific
The more context you provide, the better the AI can help:
**Less effective:**
```
"Help with the report"
```
**More effective:**
```
"Help me write the executive summary for our Q1 sales report.
Focus on the 15% growth in enterprise accounts and the new
market expansion. Keep it under 200 words."
```
### Use Follow-ups
AI conversations build on context:
```
You: Summarize this article [link]
AI: [provides summary]
You: Now create 3 tweet threads from the key points
AI: [creates tweets based on the summary]
```
### Give Feedback
Help AI improve its responses:
* "That's good, but can you make it more formal?"
* "Can you expand on the second point?"
* "That's not quite what I meant, I was looking for..."
## Best Practices
Keep personal, sensitive, or one-on-one topics in DMs rather than public channels.
DMs often carry implicit urgency. Try to respond within a reasonable timeframe or set expectations.
If a DM discussion becomes relevant to the whole team, summarize it in a project channel.
AI coworkers are great for drafts, summaries, brainstorming, and research. Provide clear context for best results.
## Troubleshooting
* They must be in your workspace
* Check if they've been removed or deactivated
* Try searching by full name or email
* Check your notification settings
* Verify the conversation isn't muted
* Check your device notification permissions
* Check your internet connection
* The AI may be processing a complex request
* Try refreshing the page
* Simplify your request if it's very complex
## Next Steps
Organize conversations with threaded replies.
Learn more about AI capabilities.
# Chat Overview
Source: https://docs.trilo.chat/chat/overview
Real-time communication with your team through channels, direct messages, and more
Trilo Chat keeps your team connected with real-time messaging built right into your workspace. Communicate in project channels, have private conversations via direct messages, and even chat with AI coworkers.
## Chat Features
Dedicated chat channels for each project, keeping conversations organized.
Private one-on-one conversations with team members or AI coworkers.
Keep discussions organized with threaded conversations.
Jump on calls directly from chat for real-time collaboration.
## Chat Types
Trilo offers different ways to communicate:
### Project Channels
Every project has a built-in chat channel:
* Automatically created with each project
* All project members can participate
* Perfect for project-related discussions
* Messages stay with the project context
### Direct Messages (DMs)
Private conversations between two people:
* One-on-one with team members
* Chat directly with AI coworkers
* Private and confidential
* Great for quick questions and personal matters
### AI Conversations
Chat with AI coworkers:
* Ask questions and get answers
* Delegate tasks through conversation
* Get AI assistance anytime
* Each AI has specialized capabilities
## Message Features
### Rich Text
Format your messages:
* **Bold** and *italic* text
* Bullet and numbered lists
* Code blocks and inline code
* Links with previews
### Attachments
Share files directly in chat:
* Images display inline
* Documents are downloadable
* Multiple files per message
* Drag and drop to upload
### Reactions
Respond quickly with emoji reactions:
* React to any message
* Multiple reactions per message
* See who reacted
* Quick acknowledgment without a reply
### Mentions
Get someone's attention:
* `@username` to mention individuals
* Mentioned users receive notifications
* Highlight important messages for specific people
### Pins and Announcements
Highlight important messages:
* **Pin** messages to keep them visible
* **Announcements** stand out in the channel
* Mark messages as **Important** or **Urgent**
## Real-Time Features
### Presence
See who's available:
* Green dot indicates online users
* See who's viewing the same channel
* Know when teammates are active
### Typing Indicators
Know when someone is responding:
* "Sarah is typing..." appears when composing
* Multiple people typing shows simultaneously
* Helps avoid message collisions
### Instant Delivery
Messages appear immediately:
* No refresh needed
* Real-time sync across devices
* Notifications for new messages
## Navigation
### Sidebar
Access your conversations from the sidebar:
* **Projects**: Click project name to access its channel
* **Direct Messages**: Listed under DMs section
* **AI Coworkers**: Chat with AI from the coworkers section
### Unread Indicators
Stay on top of new messages:
* Bold text indicates unread messages
* Badge count shows number of unread
* Red indicator for urgent mentions
### Search
Find past conversations:
* Search within a channel
* Search across all messages
* Filter by sender, date, or content type
## Keyboard Shortcuts
| Action | Shortcut |
| ------------ | --------------- |
| Send message | `Enter` |
| New line | `Shift + Enter` |
| Bold | `Cmd/Ctrl + B` |
| Italic | `Cmd/Ctrl + I` |
| Code | `Cmd/Ctrl + E` |
| Link | `Cmd/Ctrl + K` |
| Search | `Cmd/Ctrl + F` |
## Getting Started
Navigate to any project from the sidebar.
Access the project's chat channel.
Type in the message box and press Enter.
Click on a team member to start a direct message.
## Best Practices
Keep project-related conversations in project channels. This keeps context together and makes it easy for team members to catch up.
Personal matters, quick questions, and off-topic conversations work better in direct messages.
When a conversation branches off, use threads to keep the main channel clean.
A quick emoji reaction acknowledges a message without adding noise to the channel.
## Next Steps
Learn about project-based communication.
Master one-on-one conversations.
# Project Channels
Source: https://docs.trilo.chat/chat/project-channels
Communicate with your team in dedicated project chat channels
Every project in Trilo has a built-in chat channel where team members can discuss work, share updates, and collaborate in real-time. Project channels keep conversations organized and contextual.
## Accessing Project Channels
Click on a project in the sidebar.
Click **Chat** in the project navigation.
You're now in the project channel.
## Who Can Access
Project channels are available to:
* All members of the project
* Workspace admins (access to all projects)
* Invited guests (if given project access)
## Sending Messages
### Basic Messages
Type your message and press **Enter** to send.
### Rich Formatting
Use markdown or the formatting toolbar:
| Format | Markdown | Shortcut |
| -------- | ------------- | -------------- |
| **Bold** | `**text**` | `Cmd/Ctrl + B` |
| *Italic* | `*text*` | `Cmd/Ctrl + I` |
| `Code` | `` `code` `` | `Cmd/Ctrl + E` |
| Link | `[text](url)` | `Cmd/Ctrl + K` |
| List | `- item` | — |
| Numbered | `1. item` | — |
### Multi-line Messages
Press **Shift + Enter** to add new lines without sending.
### Code Blocks
Share code with syntax highlighting:
````
```javascript
function hello() {
console.log("Hello, World!");
}
```
````
## Attachments
### Uploading Files
Share files in the channel:
1. Click the attachment icon, or
2. Drag and drop files into the message area
3. Add optional comment
4. Send
### Supported Files
* **Images**: PNG, JPG, GIF (display inline)
* **Documents**: PDF, Word, Excel (downloadable)
* **Videos**: MP4 (playable)
* **Other**: Any file type
### Screenshots
Quickly share screenshots:
1. Take a screenshot
2. Paste directly into the message area (`Cmd/Ctrl + V`)
3. Add context if needed
4. Send
## Mentions
### Mentioning People
Use `@` to mention team members:
* Type `@` followed by their name
* Select from the dropdown
* They'll be notified
**Example:**
```
@sarah Can you review the latest design?
```
### Mention Notifications
When mentioned, users receive:
* In-app notification
* Email notification (if enabled)
* Badge indicator in the sidebar
## Reactions
### Adding Reactions
React to messages with emoji:
1. Hover over a message
2. Click the reaction icon
3. Select an emoji
4. Your reaction appears on the message
### Common Reactions
| Emoji | Common Meaning |
| ----- | --------------------- |
| 👍 | Acknowledged, agree |
| ❤️ | Love it, great work |
| 🎉 | Celebration, congrats |
| 👀 | Looking into it |
| ✅ | Done, completed |
### Multiple Reactions
* Multiple people can add the same reaction (count shown)
* Same person can add multiple different reactions
* Click a reaction to add yours
## Message Priority
### Standard Messages
Regular messages for normal communication.
### Important Messages
Mark messages that need attention:
1. When composing, click the priority indicator
2. Select **Important**
3. Message displays with emphasis
### Urgent Messages
For time-sensitive matters:
1. Select **Urgent** priority
2. Message displays prominently
3. Recipients receive stronger notifications
Use urgent sparingly. Overuse diminishes its effectiveness and can create notification fatigue.
## Pins and Announcements
### Pinning Messages
Keep important messages accessible:
1. Hover over the message
2. Click the **...** menu
3. Select **Pin message**
4. Pinned messages appear in the channel header
**Good candidates for pinning:**
* Important decisions
* Key resources
* Guidelines and rules
* Contact information
### Viewing Pinned Messages
Click the pin icon in the channel header to see all pinned messages.
### Announcements
Make a message stand out:
1. Hover over your message
2. Click **...** menu
3. Select **Make announcement**
4. Message displays prominently
## Message Actions
### Edit Messages
Fix mistakes after sending:
1. Hover over your message
2. Click the **...** menu
3. Select **Edit**
4. Make changes and save
Edited messages show "edited" indicator.
### Delete Messages
Remove messages you've sent:
1. Hover over your message
2. Click **...** menu
3. Select **Delete**
4. Confirm deletion
Admins can delete any message. Regular members can only delete their own.
### Copy Message
Copy message content:
1. Hover over the message
2. Click **...** menu
3. Select **Copy**
## Reading and Catching Up
### Unread Messages
New messages since your last visit:
* Channel appears bold in sidebar
* Unread count badge shows
* Scroll to see unread messages
### Mark as Read
Messages are marked as read when you view them. You can also:
* Right-click channel and select "Mark as read"
* Scroll to the bottom to mark all as read
### Catch Up
When joining a project channel:
* Scroll up to see message history
* Use search to find specific topics
* Check pinned messages for key information
## Search in Channel
### Searching Messages
Find past conversations:
1. Open the channel
2. Press `Cmd/Ctrl + F` or click search
3. Enter your search terms
4. Results highlight matching messages
### Search Tips
* Search for keywords
* Search by sender: `from:sarah`
* Search date ranges
* Combine filters for precise results
## Channel Context
### Project Integration
Project channels connect to other project features:
* **Tasks**: Reference tasks by ID
* **Resources**: Link to knowledge base content
* **Calendar**: Discuss upcoming events
### Activity Notifications
The channel receives automatic updates about:
* New tasks created
* Task status changes (optional)
* Resource updates (optional)
* Member changes
## Best Practices
Keep discussions relevant to the project. Use DMs for personal or off-topic conversations.
When a conversation goes deep, move it to a thread to keep the main channel clean.
Many questions have been answered before. Search the channel history first.
A quick reaction shows you've seen a message without adding noise.
Keep key decisions, resources, and guidelines pinned for easy access.
## Next Steps
Learn about private one-on-one messaging.
Keep conversations organized with threads.
# Threads and Replies
Source: https://docs.trilo.chat/chat/threads-and-replies
Keep conversations organized with threaded discussions
Threads help you organize conversations by grouping related messages together. Instead of cluttering the main channel, detailed discussions can happen in their own thread.
## What Are Threads?
A thread is a focused conversation attached to a specific message. When a topic needs deeper discussion, moving to a thread keeps the main channel clean while preserving the conversation in context.
### Thread Benefits
* **Organization**: Related messages stay together
* **Focus**: Discuss one topic without distracting others
* **Context**: Thread stays connected to the original message
* **Notifications**: Control who gets notified
## Creating a Thread
### Starting a Thread
Locate the message you want to discuss further.
Hover over the message and click the thread/reply icon.
Type your message in the thread view.
Press Enter to add your reply to the thread.
### When to Use Threads
Use threads for:
* Detailed follow-up discussions
* Questions that need back-and-forth
* Side conversations that branch from main topic
* Technical discussions with lots of detail
* Feedback and review conversations
## Viewing Threads
### Thread Indicator
Messages with threads show:
* Reply count ("3 replies")
* Participant avatars
* "View thread" link
### Opening a Thread
Click on:
* The "X replies" link
* The thread icon
* Any part of the thread indicator
The thread opens in a side panel.
### Thread Panel
The thread view shows:
* Original message at the top
* All replies below
* Message input at the bottom
* Option to close and return
## Participating in Threads
### Adding Replies
1. Open the thread
2. Type your message
3. Press Enter to send
Your reply is added to the thread conversation.
### Using All Features
Thread messages support:
* Rich text formatting
* File attachments
* Reactions
* Mentions
* Code blocks
Everything you can do in the main channel works in threads.
### Following Threads
When you participate in a thread, you automatically follow it and receive notifications for new replies.
## Thread Notifications
### Who Gets Notified
By default:
* Thread participants receive notifications
* The original message author is notified
* Mentioned users are notified
### Notification Behavior
Thread notifications are separate from channel notifications:
* You might mute a channel but still get thread notifications
* Unfollow specific threads you're no longer interested in
### Managing Thread Notifications
To unfollow a thread:
1. Open the thread
2. Click the settings icon
3. Select "Unfollow thread"
## Threads vs. Main Channel
### When to Reply in Channel
* Brief acknowledgments ("Thanks!")
* Messages relevant to everyone
* New topics unrelated to existing messages
* Quick reactions
### When to Start a Thread
* Detailed responses to a specific message
* Questions that might generate discussion
* Technical deep-dives
* Feedback on specific items
* Anything that needs back-and-forth
## Thread Best Practices
Each thread should be about one topic. If the conversation shifts, consider starting a new thread or moving to the main channel.
If you're responding to something specific, use a thread. Don't clutter the channel with follow-up messages.
After a long thread discussion, post a summary in the main channel so everyone knows the outcome.
Before starting a new discussion, check if there's an existing thread on the topic.
Mention someone in a thread if they specifically need to see it. Not everyone in the channel needs every thread notification.
## Thread Examples
### Question and Answer
**Main channel:**
```
Sarah: Has anyone used the new API for authentication?
```
**Thread:**
```
Mike: Yes, I integrated it last week. What do you need to know?
Sarah: How do you handle token refresh?
Mike: You need to catch the 401 error and call /refresh endpoint...
[continued discussion]
```
### Code Review
**Main channel:**
```
Alex: Here's the PR for the login feature #142
```
**Thread:**
```
Jordan: Line 45 has a potential memory leak
Alex: Good catch! I'll fix that
Jordan: Also consider using async/await on line 78
Alex: Updated. Can you take another look?
Jordan: Looks good now! Approved.
```
### Decision Making
**Main channel:**
```
Project Lead: We need to decide on the database - PostgreSQL or MySQL?
```
**Thread:**
```
Dev 1: PostgreSQL has better JSON support
Dev 2: But MySQL might be easier to manage
Dev 1: True, but we have complex queries...
[vote and decision]
Project Lead: Decision: PostgreSQL. Updating the main channel.
```
## Finding Threads
### Search
Threads are included in search results:
* Search terms find thread content
* Results show thread context
* Click to jump to the thread
### Browsing
Look for thread indicators:
* "X replies" under messages
* Participant avatars showing activity
* Bold indicators for unread threads
## Thread Permissions
### Creating Threads
Anyone who can post in a channel can start threads.
### Replying to Threads
If you can see the original message, you can reply in its thread.
### Deleting in Threads
* Delete your own thread messages
* Admins can delete any thread message
* Deleting the original message may affect the thread
## Troubleshooting
* Search for keywords from the thread
* Look for the original message it was attached to
* Check if the original message was deleted
* Make sure you're following the thread
* Check notification settings
* Verify you haven't muted the thread or channel
* Try clicking the reply count directly
* Refresh the page
* Check for browser extensions that might interfere
## Next Steps
Take conversations to real-time calls.
Learn more about channel communication.
# Voice & Video Calls
Source: https://docs.trilo.chat/chat/voice-video-calls
Real-time audio and video communication with your team
When chat isn't enough, jump on a voice or video call directly from Trilo. Have quick discussions, share your screen, and collaborate in real-time without leaving your workspace.
## Starting a Call
### From a Channel
Navigate to a project channel or direct message.
Click the phone or video icon in the header.
Select voice-only or video call.
Team members see the active call and can join.
### From a Direct Message
1. Open the DM conversation
2. Click the call icon
3. The other person receives a call notification
## Joining a Call
### Active Call Indicator
When a call is happening:
* Call indicator appears in the channel
* "Ongoing call" badge is visible
* Participant avatars show who's in the call
### Joining
1. Click "Join call" button
2. Choose your audio/video settings
3. You're in!
## Call Features
### Audio Controls
| Control | Function |
| ---------------- | --------------------------------------- |
| **Mute** | Turn your microphone off/on |
| **Deafen** | Stop hearing others (and mute yourself) |
| **Push to talk** | Hold to speak, release to mute |
### Video Controls
| Control | Function |
| ----------------- | ------------------------------------------ |
| **Camera on/off** | Toggle your video feed |
| **Camera select** | Choose which camera to use |
| **Background** | Blur or virtual backgrounds (if available) |
### Screen Sharing
Share your screen with participants:
Find the screen share button in call controls.
* Entire screen
* Specific window
* Browser tab
Click Share. Others see your screen.
Click Stop Sharing when done.
## During the Call
### Participant List
See who's in the call:
* View all participants
* See who's speaking (highlighted)
* See muted status
### Speaker Indicator
Visual feedback shows who's talking:
* Speaking indicator around avatar
* Audio level visualization
* Makes it easy to follow conversation
### Layout Options
Choose how participants are displayed:
* **Grid**: All participants equal size
* **Speaker focus**: Active speaker larger
* **Presentation**: Screen share prominent
## Managing Participants
### As Host
If you started the call:
* You can mute others if needed
* Remove participants if necessary
* End the call for everyone
### As Participant
* Control your own audio/video
* Leave the call when done
* Request to share screen
## Call Quality
### Optimizing Connection
For best call quality:
* Use a stable internet connection
* Close bandwidth-heavy applications
* Use headphones to prevent echo
* Enable hardware acceleration in browser
### Troubleshooting Quality
| Issue | Solution |
| ----------------- | ---------------------------------------- |
| Echo | Use headphones or mute when not speaking |
| Choppy audio | Check internet speed, close other apps |
| Video lag | Turn off video or reduce quality |
| Can't hear others | Check output device settings |
## Settings
### Audio Settings
Before or during a call:
* **Microphone**: Select input device
* **Speakers**: Select output device
* **Test**: Preview your audio
### Video Settings
Configure your camera:
* **Camera**: Select which camera to use
* **Preview**: See how you look before joining
* **Quality**: Adjust video resolution if needed
### Default Settings
Set your preferences:
1. Go to **Settings > Audio & Video**
2. Choose default microphone
3. Choose default camera
4. Set join preferences (camera on/off by default)
## Meeting Best Practices
Before important calls, test your audio and video to avoid delays.
Background noise can be distracting. Stay muted unless you're talking.
Prevents echo and improves audio quality for everyone.
Face a light source (like a window) for better video quality.
Wired connections are more reliable than WiFi for important calls.
## Call Etiquette
### Starting Calls
* Check if others are available before calling
* For scheduled meetings, use calendar events
* Give advance notice for longer discussions
### During Calls
* Introduce yourself if joining late
* Wait for pauses before speaking
* Keep yourself muted when not speaking
* Stay engaged (no multitasking on camera)
### Ending Calls
* Summarize decisions and action items
* Confirm next steps
* Say goodbye before leaving
## Accessibility
### Captions
If available:
* Enable live captions for audio
* Captions appear on screen in real-time
* Helpful for hearing-impaired participants
### Keyboard Controls
| Shortcut | Action |
| -------- | ------------------- |
| `M` | Toggle mute |
| `V` | Toggle video |
| `S` | Toggle screen share |
| `L` | Leave call |
## Privacy
### In-Call Privacy
* Calls are private to participants
* No recording unless explicitly enabled
* Screen sharing only shows what you choose
### Recording
If call recording is enabled:
* All participants are notified
* Recording is stored securely
* Access is controlled by permissions
## Troubleshooting
* Check your microphone is unmuted
* Verify the correct input device is selected
* Test your microphone in settings
* Check browser permissions for microphone
* Check your volume and speaker settings
* Verify output device is correct
* Check if you're deafened
* Test speakers with other audio
* Check camera permissions in browser
* Make sure camera isn't in use by another app
* Try selecting a different camera
* Refresh and rejoin the call
* Grant screen sharing permission when prompted
* Try sharing a different screen or window
* Some apps/content may be blocked from sharing
* Check browser permissions
* Check your internet connection
* Move closer to WiFi router or use ethernet
* Close other bandwidth-heavy applications
* Try rejoining the call
## Next Steps
Schedule meetings in advance.
Learn about channel communication.
# Inviting Members
Source: https://docs.trilo.chat/collaboration/inviting-members
Add team members to your workspace and projects
Building your team in Trilo starts with inviting members. This guide covers how to add team members, manage invitations, and configure access.
## Inviting to Your Workspace
### Sending Invitations
Click **Settings** in the sidebar.
Navigate to the **Members** section.
Click the **Invite members** button.
Add one or more email addresses, separated by commas.
Choose the role for these new members.
Click **Send invitations**.
### Invitation Roles
When inviting, choose the appropriate role:
| Role | Description | Best For |
| ---------- | ---------------------------------------------- | ------------------------------- |
| **Admin** | Manage workspace, members, and settings | Team leads, managers |
| **Member** | Create and edit content in accessible projects | Regular team members |
| **Guest** | Limited access to specific projects | External collaborators, clients |
Learn more about what each role can do.
## The Invitation Process
### What Invitees Receive
Invited people receive an email containing:
* Workspace name and who invited them
* Link to accept the invitation
* Instructions for getting started
### Accepting an Invitation
When someone clicks the invitation link:
1. **New users**: Create a Trilo account, then join the workspace
2. **Existing users**: Sign in and join the workspace directly
### Invitation Status
Track invitation status in Members settings:
| Status | Meaning |
| ------------ | ---------------------------------- |
| **Pending** | Invitation sent, not yet accepted |
| **Accepted** | Invitation accepted, member active |
| **Expired** | Invitation not accepted in time |
### Resending Invitations
If someone hasn't received or lost their invitation:
1. Go to **Settings > Members**
2. Find the pending invitation
3. Click **Resend**
4. A new email is sent
### Revoking Invitations
Cancel a pending invitation:
1. Go to **Settings > Members**
2. Find the pending invitation
3. Click **Revoke** or the X icon
4. The invitation link no longer works
## Inviting Guests
Guests have limited access, perfect for external collaborators.
### When to Use Guest Access
* External contractors or freelancers
* Clients who need project visibility
* Partners collaborating on specific work
* Temporary collaborators
### Inviting a Guest
Go to **Settings > Members > Invite**.
Add the guest's email address.
Choose **Guest** from the role dropdown.
Choose which projects the guest can access.
The guest receives an invitation with limited access.
### Guest Limitations
Guests can:
* Access assigned projects only
* View and interact with allowed content
* Participate in project chat
* Be assigned tasks (depending on permissions)
Guests cannot:
* See other projects in the workspace
* Access workspace settings
* Invite other members
* See the full member list
## Bulk Invitations
### Inviting Multiple People
Add several people at once:
1. In the invite form, enter multiple emails
2. Separate with commas or new lines
3. All receive the same role
4. Send invitations
**Example:**
```
alice@company.com, bob@company.com, carol@company.com
```
### Different Roles for Different People
To assign different roles:
* Send separate invitations for each role
* Or invite everyone as Members, then upgrade specific people to Admin
## Managing Pending Invitations
### Viewing Pending Invitations
In **Settings > Members**, you can see:
* All pending invitations
* When each was sent
* Who sent the invitation
* The assigned role
### Invitation Expiration
Invitations expire after a set period (typically 7 days). After expiration:
* The link no longer works
* You can send a new invitation
## After Someone Joins
### New Member Onboarding
When someone accepts an invitation:
1. They appear in the Members list
2. They get access based on their role
3. They can start exploring the workspace
### Adding to Projects
For members who need project access:
1. Go to the project
2. Open project settings > Members
3. Add the new member
4. Set their project role
Or with default access settings, members may automatically have access to projects.
## Invitation Best Practices
Give people the minimum access they need. Start with Member and upgrade to Admin only if necessary.
When inviting, let people know (via separate email) what the workspace is for and what they'll be working on.
Check periodically for pending invitations. Follow up with people who haven't accepted.
Remove members who no longer need access. Revoke invitations that won't be accepted.
Always use Guest role for people outside your organization. This protects sensitive workspace information.
## Troubleshooting
* Check spam/junk folder
* Verify email address is correct
* Try resending the invitation
* Check if corporate email filters might block it
* The invitation may have expired
* The invitation may have been revoked
* Send a new invitation
* Verify you have Admin permissions
* Check if they're already a member
* Ensure you're entering a valid email
* They need to be added to specific projects
* Check project access settings
* Verify their role has appropriate permissions
## Removing Members
### Removing from Workspace
To remove someone completely:
1. Go to **Settings > Members**
2. Find the member
3. Click **Remove** or the menu icon
4. Confirm removal
The person loses all access immediately.
### Deactivating vs. Removing
| Action | What Happens |
| -------------- | ------------------------------------------------- |
| **Remove** | Completely removes from workspace |
| **Deactivate** | Suspends access, preserves their activity history |
Use deactivation when you might want to restore access later.
## Next Steps
Understand access control in detail.
Learn about working together in real-time.
# Real-Time Collaboration
Source: https://docs.trilo.chat/collaboration/real-time-collaboration
Work together with your team in real-time across all Trilo features
Trilo is built for real-time collaboration. See changes as they happen, know when teammates are online, and work together seamlessly whether you're in the same room or across the world.
## Real-Time Features
### Instant Updates
Everything syncs in real-time:
* **Messages** appear instantly
* **Task changes** reflect immediately
* **Document edits** show as you type
* **Calendar updates** sync across views
No refreshing needed—changes appear as they happen.
### Presence Indicators
Know who's active in your workspace:
| Indicator | Meaning |
| -------------- | ------------------------- |
| **Green dot** | User is online and active |
| **Yellow dot** | User is online but idle |
| **No dot** | User is offline |
Presence shows in:
* Member lists
* Chat conversations
* Document editing
## Collaborative Editing
### Working on Documents Together
Multiple people can edit the same page simultaneously:
**What you see:**
* Other users' cursors with their names
* Changes appearing in real-time
* Who's currently viewing the document
**How it works:**
1. Open a page that others are viewing
2. See their cursors and selections
3. Type and watch your changes appear for everyone
4. Their changes appear on your screen instantly
### Conflict-Free Editing
Trilo uses advanced technology to prevent conflicts:
* Two people can type in different places simultaneously
* Overlapping edits are merged intelligently
* No "save conflicts" or locked documents
* Changes sync automatically
### Best Practices for Co-Editing
Use chat alongside document editing to coordinate who's working on what section.
When co-editing, try to work in different sections of the document to avoid stepping on each other.
Instead of editing someone else's work directly, add comments for discussion.
## Real-Time Chat
### Instant Messaging
Chat messages appear immediately:
* Send a message, it appears for everyone
* No delay or polling
* Typing indicators show when someone is responding
### Typing Indicators
Know when someone is responding:
```
Sarah is typing...
```
Multiple people typing shows all names.
### Message Delivery
Messages are delivered instantly to:
* Active users (appear immediately)
* Offline users (appear when they return)
* Mobile users (via push notifications if enabled)
## Task Collaboration
### Live Task Updates
When someone updates a task:
* Status changes appear immediately
* Assignment changes show in real-time
* Comments appear without refresh
### Seeing Who's Working
On task boards:
* See who's viewing the same board
* Watch tasks move between columns
* Observe real-time progress
## Calendar Collaboration
### Shared Calendar Updates
* New events appear for all participants
* Changes sync across devices
* Booking availability updates in real-time
### Avoiding Conflicts
The calendar shows:
* When teammates have events
* Conflicting times
* Available slots for scheduling
## Notifications
### Real-Time Notifications
Get notified immediately about:
| Event | Notification |
| --------------- | ------------------------ |
| New message | In-app alert, sound |
| @mention | Highlighted notification |
| Task assigned | Alert with task details |
| Calendar invite | Event notification |
### Notification Delivery
Notifications arrive via:
* **In-app**: Badge counts and alerts
* **Desktop**: System notifications
* **Mobile**: Push notifications
* **Email**: For missed notifications (configurable)
## Working Across Time Zones
### Time Zone Support
Trilo handles time zones automatically:
* Events show in your local time
* Teammates see times in their local time
* All times convert correctly across zones
### Availability Awareness
See teammate availability:
* Check their local time
* See their online status
* Respect working hours
### Async-Friendly Features
For teams across time zones:
* Messages wait for recipients
* Task updates are logged with timestamps
* Activity history shows what happened while you were away
## Offline Behavior
### When You're Offline
Trilo handles offline gracefully:
* View cached content
* Draft messages (sent when reconnected)
* See an offline indicator
### Reconnecting
When connection returns:
* Drafts are sent
* New content syncs
* You're back to real-time
## Performance
### Optimized for Speed
Real-time features are optimized to be:
* Fast even with many users
* Efficient with bandwidth
* Responsive on all devices
### Large Teams
Trilo scales for large teams:
* Hundreds of concurrent users
* Multiple simultaneous editors
* High-volume chat
## Collaboration Tips
### General Tips
Check who's online before starting collaborative work. Coordinate timing for better collaboration.
When editing documents together, keep a chat conversation open to coordinate.
The system handles conflicts well. Don't avoid co-editing—embrace it.
For real-time features to work best, maintain a stable internet connection.
### For Remote Teams
Identify times when most team members are online for real-time collaboration.
Leave detailed messages and task updates for teammates in different time zones.
Summarize real-time discussions for those who weren't present.
## Troubleshooting
* Check your internet connection
* Look for offline indicator
* Try refreshing the page
* Log out and back in if issues persist
* Presence updates every few seconds
* Brief delays are normal
* Extended issues may indicate connection problems
* This shouldn't happen with Trilo's conflict resolution
* If it does, refresh and check history
* Contact support if the issue persists
* Check notification settings
* Verify browser/device permissions
* Disable and re-enable notifications
## Next Steps
Dive deeper into real-time messaging.
Learn about collaborative documents.
# Roles and Permissions
Source: https://docs.trilo.chat/collaboration/roles-permissions
Understand access control and what each role can do in Trilo
Roles and permissions control what people can see and do in your workspace. Understanding these helps you set up appropriate access for everyone on your team.
## Role Hierarchy
Trilo has two levels of roles:
1. **Workspace roles**: Control access across the entire workspace
2. **Project roles**: Control access within specific projects
### Workspace Roles
| Role | Description |
| ---------- | ------------------------------------------- |
| **Owner** | Full control including billing and deletion |
| **Admin** | Manage members, settings, and all content |
| **Member** | Create and edit in accessible projects |
| **Guest** | Limited access to specific projects only |
### Project Roles
| Role | Description |
| ----------------- | ----------------------------- |
| **Project Admin** | Full control over the project |
| **Editor** | Create and edit content |
| **Viewer** | View-only access |
## Workspace Roles in Detail
### Owner
The workspace owner has complete control:
**Can do everything, plus:**
* Access and modify billing
* Delete the workspace
* Transfer ownership
* View all analytics
**Notes:**
* Every workspace has exactly one owner
* Ownership can be transferred to another Admin
* Usually the person who created the workspace
### Admin
Administrators manage the workspace day-to-day:
**Can:**
* Invite and remove members
* Change member roles (except owner)
* Access all projects
* Modify workspace settings
* Create and archive areas and projects
* View workspace analytics
**Cannot:**
* Access billing (unless also owner)
* Delete the workspace
* Change the owner
### Member
Regular team members who do the work:
**Can:**
* Access projects they're added to
* Create and edit content in their projects
* Participate in chat
* Manage their own tasks
* Update their profile
**Cannot:**
* Access workspace settings
* Invite new members
* See projects they're not part of
* Change other members' roles
### Guest
External collaborators with limited access:
**Can:**
* Access specific projects they're invited to
* View and interact with allowed content
* Participate in project chat
* Be assigned tasks (if permitted)
**Cannot:**
* See other projects
* View workspace members list
* Access any settings
* Invite others
* See workspace structure outside their projects
## Project Roles in Detail
### Project Admin
Full control within a specific project:
**Can:**
* Manage project settings
* Add/remove project members
* Change project member roles
* Delete the project
* All Editor capabilities
### Editor
Content creators and collaborators:
**Can:**
* Create and edit all content types
* Manage tasks (create, edit, assign)
* Upload resources
* Participate in chat
* Edit pages, spreadsheets, boards
### Viewer
Read-only access:
**Can:**
* View all project content
* Read chat messages
* See task lists
**Cannot:**
* Edit any content
* Create tasks
* Send messages (in some configurations)
* Upload files
## Permission Matrix
### Workspace-Level Permissions
| Action | Owner | Admin | Member | Guest |
| ------------------------- | ----- | ----- | ------- | ----- |
| View workspace settings | Yes | Yes | No | No |
| Modify workspace settings | Yes | Yes | No | No |
| Manage billing | Yes | No | No | No |
| Invite members | Yes | Yes | No | No |
| Remove members | Yes | Yes | No | No |
| Create areas | Yes | Yes | No | No |
| Create projects | Yes | Yes | Limited | No |
| Access all projects | Yes | Yes | No | No |
| Delete workspace | Yes | No | No | No |
### Project-Level Permissions
| Action | Project Admin | Editor | Viewer |
| ----------------------- | ------------- | ------ | ------ |
| View project | Yes | Yes | Yes |
| Manage project settings | Yes | No | No |
| Add/remove members | Yes | No | No |
| Create tasks | Yes | Yes | No |
| Edit tasks | Yes | Yes | No |
| Create resources | Yes | Yes | No |
| Edit resources | Yes | Yes | No |
| Send messages | Yes | Yes | Varies |
| Delete project | Yes | No | No |
## Managing Roles
### Changing Workspace Roles
Navigate to **Settings > Members**.
Locate the person whose role you want to change.
Click on their current role.
Choose the new role from the dropdown.
Changes take effect immediately.
**Who can change roles:**
* Owners can change any role
* Admins can change Member and Guest roles
* No one can change their own role to a higher level
### Changing Project Roles
Open the project and navigate to settings.
Go to the Members section.
Locate the person in the member list.
Select their new project role.
## Role Strategies
### Small Teams (2-10 people)
* **Owner**: Founder or team lead
* **Admins**: 1-2 key team members
* **Members**: Everyone else
Keep it simple—most people can be Members.
### Growing Teams (10-50 people)
* **Owner**: CEO or department head
* **Admins**: Team leads, department managers
* **Members**: Regular employees
* **Guests**: Contractors, external partners
Use project roles to give specific people more control in their areas.
### Enterprise (50+ people)
* **Owner**: IT administrator or executive
* **Admins**: Department heads, team leads
* **Members**: Most employees
* **Guests**: External collaborators, clients
Use detailed project permissions and consider:
* Limiting Admin count
* Using Guests more liberally for external access
* Project-level permissions for fine-grained control
## Best Practices
Give people the minimum permissions they need. It's easier to grant more access than to restrict it later.
Too many admins can lead to inconsistent settings and confusion. Keep Admin count low.
Always use Guest role for people outside your organization. This protects sensitive information.
Audit who has access periodically. Remove access for people who no longer need it.
Write down who gets what role and why. This helps with consistency as your team grows.
## Special Cases
### Transferring Ownership
To transfer workspace ownership:
1. Both parties must have accounts
2. Current owner initiates transfer
3. New owner accepts
4. Old owner becomes Admin
### Temporary Elevated Access
When someone needs temporary higher access:
1. Elevate their role as needed
2. Set a reminder to review
3. Reduce role when no longer needed
### Emergency Access
If the owner is unavailable:
* Admins can handle most operations
* Contact Trilo support for ownership issues
* Have a backup plan for critical access
## Troubleshooting
* Check if they're added to the project
* Verify their project role allows access
* Ensure the project isn't archived
* Verify you have permission (Admin+ to change roles)
* You can't elevate someone above your own level
* Owners can only be changed through ownership transfer
* Review which projects they're added to
* Check project-level permissions
* Remove from projects they shouldn't access
* Only Owner or Admin can promote to Admin
* Go to Settings > Members
* Change their workspace role
## Next Steps
Add people to your workspace.
Learn about working together.
# Authentication
Source: https://docs.trilo.chat/developers/cli/authentication
Authenticate the Trilo CLI with browser OAuth login or Personal Access Tokens for CI/CD
The CLI supports two authentication methods: browser-based OAuth login (for interactive use) and Personal Access Tokens (for CI/CD and automation).
## Browser Login (OAuth)
The simplest way to authenticate:
```bash theme={null}
trilo login
```
This will:
1. Open your browser to the Trilo authorization page
2. Ask you to approve CLI access to your workspace
3. Store your token securely in `~/.config/trilo/credentials.json`
4. Auto-select your workspace (or prompt you to choose if you have multiple)
Tokens are automatically refreshed when they expire — you should only need to run `trilo login` once.
To log out and clear stored credentials:
```bash theme={null}
trilo logout
```
## Personal Access Tokens (PAT)
For CI/CD pipelines, scripts, and automation, use a Personal Access Token:
1. Go to **Settings > Tokens** in the Trilo web app
2. Create a new token with the scopes you need
3. Set it as an environment variable:
```bash theme={null}
export TRILO_TOKEN="trilo_pat_xxx"
```
Or write it to the config file:
```bash theme={null}
mkdir -p ~/.config/trilo
echo '{"token":"trilo_pat_xxx","url":"https://api.trilo.chat"}' > ~/.config/trilo/credentials.json
chmod 600 ~/.config/trilo/credentials.json
```
PAT tokens provide persistent access to your workspace. Store them securely and rotate them periodically. Never commit tokens to version control.
## Workspace Selection
After authenticating, set your default workspace:
```bash theme={null}
# List available workspaces
trilo workspace list
# Set default workspace
trilo workspace set
# Check current workspace
trilo workspace current
```
You can also override the workspace per-command:
```bash theme={null}
trilo tasks list --workspace
```
## Environment Variables
| Variable | Description | Default |
| -------------------- | -------------------------------- | ------------------------ |
| `TRILO_TOKEN` | Override stored token | — |
| `TRILO_API_URL` | API endpoint URL | `https://api.trilo.chat` |
| `TRILO_FRONTEND_URL` | Frontend URL (for `trilo login`) | `https://app.trilo.chat` |
## Configuration Files
All config is stored in `~/.config/trilo/` (respects `XDG_CONFIG_HOME`):
| File | Contents | Permissions |
| ------------------ | ------------------------------------ | ------------------- |
| `credentials.json` | Access token, refresh token, API URL | `0600` (owner-only) |
| `config.json` | Default workspace ID and name | `0600` (owner-only) |
## CI/CD Example
```yaml theme={null}
# GitHub Actions example
jobs:
create-task:
runs-on: ubuntu-latest
steps:
- name: Create deployment task
env:
TRILO_TOKEN: ${{ secrets.TRILO_PAT }}
run: |
bunx trilo tasks create \
--title "Deploy ${{ github.sha }}" \
--project-id ${{ vars.TRILO_PROJECT_ID }} \
--status in_progress \
--priority high
```
# Commands Reference
Source: https://docs.trilo.chat/developers/cli/commands
Complete reference for all Trilo CLI commands including tasks, pages, projects, events, messages, and workflows
## Global Flags
These flags work with any command:
| Flag | Description |
| ------------------ | ---------------------------------------------------- |
| `--json` | Force JSON output (auto-enabled when piped) |
| `--verbose` | Print HTTP method, URL, status, and timing to stderr |
| `--workspace ` | Override default workspace for this command |
| `--help` | Show help for any command |
| `--version` | Show CLI version |
## Tasks
```bash theme={null}
# List tasks (with optional filters)
trilo tasks list [--project-id ] [--status ] [--assignee ] [--limit ]
# Get a specific task
trilo tasks get --id
# Create a task
trilo tasks create --title "Bug: login fails on Safari" --project-id \
[--description "..."] [--status todo] [--priority high] [--assignee ]
# Update a task
trilo tasks update --id [--title "..."] [--status done] [--priority low]
```
## Pages
```bash theme={null}
# List pages
trilo pages list [--project-id ]
# Get a specific page
trilo pages get --id
# Create a page
trilo pages create --title "Sprint Retro Notes" --project-id
```
## Projects
```bash theme={null}
# List all projects
trilo projects list
# Get a specific project
trilo projects get --id
```
## Events
```bash theme={null}
# List events (with optional date range)
trilo events list [--start 2025-01-01T00:00:00Z] [--end 2025-01-31T23:59:59Z]
# Create an event
trilo events create --title "Team standup" \
--start 2025-01-15T09:00:00Z --end 2025-01-15T09:30:00Z [--all-day]
```
## Members
```bash theme={null}
# List workspace members
trilo members list
```
## Messages
```bash theme={null}
# List messages in a project channel
trilo messages list --project-id [--limit 20]
# Send a message to a project channel
trilo messages send --content "Deploy is live!" \
--project-id --sender-id
# Send a direct message
trilo messages send-direct --content "Quick question..." \
--conversation-id --sender-id
```
`--sender-id` is your workspace member ID. You can find it with `trilo members list`.
## Workflows
```bash theme={null}
# Run a workflow
trilo workflows run --page-id
# Check workflow run status
trilo workflows status --page-id
# Continue a paused workflow (approve a review gate)
trilo workflows continue --page-id --run-id
```
## Shell Completions
Tab completion for all commands and flags:
```bash theme={null}
# Auto-detect your shell and install
trilo completions install
# Or output the script to stdout
trilo completions zsh
trilo completions bash
trilo completions fish
```
After installing, restart your shell or run `source ~/.zshrc` (for zsh).
## Scripting Examples
The CLI outputs JSON when piped, making it composable with `jq` and other tools:
```bash theme={null}
# Count tasks in a project
trilo tasks list --project-id --json | jq '.data | length'
# Get titles of blocked tasks
trilo tasks list --status blocked --json | jq -r '.data[].title'
# Export projects as CSV
trilo projects list --json | jq -r '.data[] | [.name, .id] | @csv'
# Create a task and capture its ID
TASK_ID=$(trilo tasks create --title "From script" --project-id \
--json | jq -r '.data.id')
echo "Created task: $TASK_ID"
```
# CLI Overview
Source: https://docs.trilo.chat/developers/cli/overview
Install and use the Trilo CLI to manage tasks, pages, projects, events, and messages from your terminal
The Trilo CLI (`trilo`) lets you interact with your workspace directly from the terminal. List tasks, send messages, create pages, trigger workflows — all without opening a browser.
## What You Can Do
```bash theme={null}
trilo tasks list --status in_progress --json
trilo messages send --content "Deploy complete" --project-id --sender-id
trilo workflows run --page-id
trilo projects list --json | jq '.[].name'
```
| Category | Commands |
| ------------- | --------------------------------- |
| **Tasks** | `list`, `get`, `create`, `update` |
| **Pages** | `list`, `get`, `create` |
| **Projects** | `list`, `get` |
| **Events** | `list`, `create` |
| **Members** | `list` |
| **Messages** | `send`, `send-direct`, `list` |
| **Workflows** | `run`, `status`, `continue` |
## Quick Start
The CLI runs via [Bun](https://bun.sh). From the Trilo monorepo:
```bash theme={null}
cd packages/cli && bun link
```
```bash theme={null}
trilo login
```
This opens your browser to authorize the CLI. Your token is stored securely in `~/.config/trilo/`.
```bash theme={null}
trilo tasks list
trilo projects list --json
```
## Authentication Methods
Run `trilo login` to authenticate via your browser. Tokens auto-refresh when expired.
Set `TRILO_TOKEN` env var for CI/CD and scripting. Create tokens in workspace settings.
## Output Formats
The CLI auto-detects your context:
* **Interactive terminal** — human-readable tables
* **Piped** (`trilo tasks list | jq`) — auto-switches to JSON
* **`--json` flag** — forces JSON in all contexts
This makes the CLI composable with standard Unix tools like `jq`, `grep`, and `awk`.
# Quickstart
Source: https://docs.trilo.chat/developers/cli/quickstart
Install the Trilo CLI and run your first commands in under 2 minutes
Get the Trilo CLI running on your machine in under 2 minutes.
## Prerequisites
You need [Bun](https://bun.sh) installed (v1.2+):
```bash theme={null}
curl -fsSL https://bun.sh/install | bash
```
## Setup
From the Trilo monorepo:
```bash theme={null}
cd packages/cli && bun link
```
This makes the `trilo` command available globally.
Verify it works:
```bash theme={null}
trilo --version
```
```bash theme={null}
trilo login
```
Your browser opens to authorize the CLI. Click **Authorize** and you're done — the token is stored securely and refreshes automatically.
For CI/CD or scripting, use a [Personal Access Token](/developers/cli/authentication#personal-access-tokens-pat) instead.
```bash theme={null}
# List your projects
trilo projects list
# List tasks in a project
trilo tasks list --limit 5
# Get JSON output for scripting
trilo tasks list --limit 100 --json | jq '.data | length'
```
Tab completion for all commands and flags:
```bash theme={null}
trilo completions install
```
Restart your shell, then try `trilo tasks ` to see completions.
## What's Next?
OAuth login, PAT tokens, CI/CD setup, and environment variables.
All 19 commands with examples and scripting patterns.
## Common Workflows
### Quick task check
```bash theme={null}
trilo tasks list --status in_progress
```
### Create a task from terminal
```bash theme={null}
trilo tasks create --title "Fix login bug" --project-id --priority high
```
### Pipe JSON to other tools
```bash theme={null}
# Export project list as CSV
trilo projects list --json | jq -r '.data[] | [.name, .id] | @csv'
# Count blocked tasks
trilo tasks list --status blocked --json | jq '.data | length'
```
### Trigger a workflow
```bash theme={null}
trilo workflows run --page-id
trilo workflows status --page-id
```
## Troubleshooting
The CLI needs port 9876 for the OAuth callback. Check what's using it:
```bash theme={null}
lsof -i :9876
```
Kill the process or wait for it to finish, then retry `trilo login`.
Your token may have expired and refresh failed. Run `trilo login` again to get a fresh token.
If using a PAT, check that `TRILO_TOKEN` is set correctly and the token hasn't been revoked.
Make sure you have the right workspace selected:
```bash theme={null}
trilo workspace current
trilo workspace list
trilo workspace set
```
Check that you can reach the API:
```bash theme={null}
curl -s https://api.trilo.chat/health
```
If using a custom API URL, verify `TRILO_API_URL` is correct.
# Claude Code
Source: https://docs.trilo.chat/developers/mcp/clients/claude-code
Set up Trilo's MCP server in Claude Code with OAuth or Personal Access Token authentication
[Claude Code](https://docs.anthropic.com/en/docs/claude-code) is Anthropic's agentic coding tool for the terminal. It supports both **OAuth** (recommended) and **PAT** authentication for MCP connections.
## Setup with OAuth (Recommended)
The fastest way to connect — no token needed.
In your terminal, run:
```bash theme={null}
claude mcp add --transport http --scope user trilo https://api.trilo.chat/mcp
```
The `--scope user` flag makes Trilo available across all your projects. Use `--scope local` (default) to limit it to the current project only.
Inside Claude Code, run the `/mcp` command. Select **Authenticate** for the Trilo server — this will open your browser to authorize access to your Trilo account.
Back in Claude Code, ask:
```
List my Trilo workspaces
```
If it returns your workspace data, you're all set.
## Setup with PAT (Alternative)
If you prefer a Personal Access Token instead of OAuth:
In Trilo, go to **Profile Settings** > **API** > **Create Token**. Select the scopes you need (`mcp:read`, `mcp:write`) and copy the token.
**Option A — CLI command:**
```bash theme={null}
claude mcp add --transport http --scope user \
--header "Authorization: Bearer YOUR_TOKEN_HERE" \
trilo https://api.trilo.chat/mcp
```
**Option B — Config file** (`~/.claude.json`):
```json theme={null}
{
"mcpServers": {
"trilo": {
"type": "http",
"url": "https://api.trilo.chat/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
```
You can also use `.mcp.json` in your project root to share the config with your team (supports environment variable expansion like `${TRILO_PAT}`).
Ask Claude Code:
```
List my Trilo workspaces
```
## Options
You can append query parameters to the MCP URL for additional control:
| Parameter | Description | Example |
| -------------- | -------------------------------- | ------------------------------------------------- |
| `workspace_id` | Restrict to a specific workspace | `https://api.trilo.chat/mcp?workspace_id=abc-123` |
| `read_only` | Force read-only mode | `https://api.trilo.chat/mcp?read_only=true` |
## Troubleshooting
Make sure you run `/mcp` inside Claude Code to trigger the authentication flow. If the browser still doesn't open, check that you have a default browser configured.
* Verify your token starts with `trilo_pat_` and is copied correctly
* Check that the `Authorization` header uses the `Bearer` prefix
* Confirm the token hasn't been revoked in **Profile Settings** > **API**
Try restarting Claude Code. Run `/mcp` to check the server status. Also verify the URL is exactly `https://api.trilo.chat/mcp` with no trailing slash.
MCP sessions expire after 30 minutes of inactivity. Claude Code usually reconnects automatically. If not, run `/mcp` and re-authenticate.
# Claude Desktop
Source: https://docs.trilo.chat/developers/mcp/clients/claude-desktop
Set up Trilo's MCP server in Claude Desktop using the Connectors UI or config file
[Claude Desktop](https://claude.ai/download) is Anthropic's desktop app for Claude. The easiest way to connect is through the **Connectors** UI, which handles OAuth automatically — no token needed.
Custom connectors require a **Pro**, **Max**, **Team**, or **Enterprise** plan.
## Setup via Connectors (Recommended)
No token needed — Claude Desktop handles authorization via OAuth.
In Claude Desktop, go to **Settings** > **Connectors**.
Scroll to the bottom and click **Add custom connector**.
Paste the Trilo MCP endpoint:
```
https://api.trilo.chat/mcp
```
You can skip the **Advanced settings** (OAuth Client ID / Secret) — Trilo's server handles OAuth automatically.
Click **Add** to save the connector. Claude Desktop will open your browser to authorize access to your Trilo account.
Click **Authorize** in your browser. The connector is now active.
In a new conversation, click the **+** button in the chat input and select **Connectors**. Toggle **Trilo** on for that conversation.
Ask Claude:
```
List my Trilo workspaces
```
If it returns your workspace data, you're connected.
**Team / Enterprise plans:** An Organization Owner must add the connector first via **Organization settings** > **Connectors**. Members can then connect individually from **Settings** > **Connectors** by clicking **Connect** next to the Trilo connector.
## Setup via Config File (Alternative)
If you prefer editing the JSON config file directly:
Open your Claude Desktop config file in a text editor:
**macOS:**
```
~/Library/Application Support/Claude/claude_desktop_config.json
```
**Windows:**
```
%APPDATA%\Claude\claude_desktop_config.json
```
Add the following to the file (create it if it doesn't exist):
```json theme={null}
{
"mcpServers": {
"trilo": {
"type": "http",
"url": "https://api.trilo.chat/mcp"
}
}
}
```
If you already have other MCP servers configured, add the `"trilo"` entry inside the existing `"mcpServers"` object.
Close and reopen Claude Desktop. It will detect the new server and open your browser to authorize access.
In a new conversation, ask:
```
List my Trilo workspaces
```
Claude Desktop does **not** connect to remote MCP servers configured with headers in `claude_desktop_config.json`. For PAT-based authentication, use the **Connectors UI** with Advanced settings, or use [Claude Code](/developers/mcp/clients/claude-code) instead.
## Options
Append query parameters to the MCP URL for additional control:
| Parameter | Description | Example |
| -------------- | -------------------------------- | ------------------------------------------------- |
| `workspace_id` | Restrict to a specific workspace | `https://api.trilo.chat/mcp?workspace_id=abc-123` |
| `read_only` | Force read-only mode | `https://api.trilo.chat/mcp?read_only=true` |
## Troubleshooting
Custom connectors require a **Pro**, **Max**, **Team**, or **Enterprise** plan. Check your subscription in Claude Desktop settings.
Make sure you've enabled the connector for the conversation. Click the **+** button in the chat input, then **Connectors**, and toggle Trilo on.
Double-check your config file path and JSON syntax. Use a JSON validator if needed — a missing comma or bracket will prevent the file from being parsed.
Restart Claude Desktop after adding the connector. Verify the URL is exactly `https://api.trilo.chat/mcp` with no trailing slash.
MCP sessions expire after 30 minutes of inactivity. Claude Desktop usually reconnects automatically. If not, restart the app.
# Cursor
Source: https://docs.trilo.chat/developers/mcp/clients/cursor
Set up Trilo's MCP server in Cursor with Personal Access Token authentication
[Cursor](https://cursor.com) is an AI-powered code editor. Connect it to Trilo via MCP to manage your workspace directly from the editor.
## Setup
In Trilo, go to **Profile Settings** > **API** > **Create Token**. Select the scopes you need (`mcp:read`, `mcp:write`) and copy the token.
Choose one of these options:
**Option A — Settings UI:**
1. Open **Cursor Settings** > **MCP**
2. Click **Add MCP Server**
3. Set the URL to `https://api.trilo.chat/mcp`
4. Add the Authorization header with your PAT
**Option B — Config file (project-level):**
Create or edit `.cursor/mcp.json` in your project root:
```json theme={null}
{
"mcpServers": {
"trilo": {
"url": "https://api.trilo.chat/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
```
Replace `YOUR_TOKEN_HERE` with the PAT you copied.
In Cursor's AI chat, ask:
```
List my Trilo workspaces
```
If it returns your workspace data, you're connected.
Using `.cursor/mcp.json` in the project root scopes the MCP connection to that project. For access across **all projects**, add the config to `~/.cursor/mcp.json` instead. Either way, add the file to your `.gitignore` to keep your token out of version control.
## Options
Append query parameters to the MCP URL for additional control:
| Parameter | Description | Example |
| -------------- | -------------------------------- | ------------------------------------------------- |
| `workspace_id` | Restrict to a specific workspace | `https://api.trilo.chat/mcp?workspace_id=abc-123` |
| `read_only` | Force read-only mode | `https://api.trilo.chat/mcp?read_only=true` |
## Troubleshooting
* Verify your token starts with `trilo_pat_`
* Check the `Authorization` header uses the `Bearer` prefix
* Confirm the token hasn't been revoked in **Profile Settings** > **API**
Restart Cursor after adding the MCP server. Verify the URL is exactly `https://api.trilo.chat/mcp` with no trailing slash.
MCP sessions expire after 30 minutes of inactivity. Cursor usually reconnects automatically. If not, restart the editor.
# Google Antigravity
Source: https://docs.trilo.chat/developers/mcp/clients/google-antigravity
Set up Trilo's MCP server in Google Antigravity with Personal Access Token authentication
[Google Antigravity](https://antigravity.google) is Google's agentic development platform. Connect it to Trilo via MCP to manage your workspace from within Agent sessions.
Google Antigravity uses `serverUrl` instead of `url` in its MCP config — make sure to use the correct field name.
## Setup
In Trilo, go to **Profile Settings** > **API** > **Create Token**. Select the scopes you need (`mcp:read`, `mcp:write`) and copy the token.
1. Open an **Agent session** and click the **"..."** menu at the top of the side panel
2. Select **MCP Servers** to open the MCP Store
3. Click **Manage MCP Servers** at the top, then **View raw config**
Add the following to your `mcp_config.json`:
```json theme={null}
{
"mcpServers": {
"trilo": {
"serverUrl": "https://api.trilo.chat/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
```
Replace `YOUR_TOKEN_HERE` with the PAT you copied.
Use `serverUrl` (not `url`) — this is specific to Google Antigravity's MCP config format.
Save the file and click **Refresh** in the Manage MCP Servers view.
In your Agent session, ask:
```
List my Trilo workspaces
```
If it returns your workspace data, you're connected.
## Options
Append query parameters to the MCP URL for additional control:
| Parameter | Description | Example |
| -------------- | -------------------------------- | ------------------------------------------------- |
| `workspace_id` | Restrict to a specific workspace | `https://api.trilo.chat/mcp?workspace_id=abc-123` |
| `read_only` | Force read-only mode | `https://api.trilo.chat/mcp?read_only=true` |
## Troubleshooting
* Verify your token starts with `trilo_pat_`
* Check the `Authorization` header uses the `Bearer` prefix
* Confirm the token hasn't been revoked in **Profile Settings** > **API**
Click **Refresh** in the Manage MCP Servers view. Also verify you used `serverUrl` (not `url`) in the config.
MCP sessions expire after 30 minutes of inactivity. Refresh the MCP connection or start a new Agent session.
# Other MCP Clients
Source: https://docs.trilo.chat/developers/mcp/clients/other-clients
Connect any MCP-compatible AI tool to your Trilo workspace using the HTTP Streamable transport
Any AI tool that supports the [Model Context Protocol](https://modelcontextprotocol.io) can connect to Trilo. Here's what you need.
## Connection Details
| Setting | Value |
| ------------------ | ------------------------------------------------------------------------------------------------------------------- |
| **Endpoint** | `https://api.trilo.chat/mcp` |
| **Transport** | HTTP ([Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)) |
| **Authentication** | `Authorization: Bearer trilo_pat_...` |
## Setup
In Trilo, go to **Profile Settings** > **API** > **Create Token**. Select the scopes you need (`mcp:read`, `mcp:write`) and copy the token.
Most MCP clients use a JSON config format. The standard config looks like:
```json theme={null}
{
"mcpServers": {
"trilo": {
"url": "https://api.trilo.chat/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
```
Replace `YOUR_TOKEN_HERE` with the PAT you copied. Refer to your client's documentation for the exact config file location, format, and field names (some clients use `serverUrl` instead of `url`).
Ask your AI tool:
```
List my Trilo workspaces
```
If it returns your workspace data, you're connected.
## Options
Append query parameters to the MCP URL for additional control:
| Parameter | Description | Example |
| -------------- | -------------------------------- | ------------------------------------------------- |
| `workspace_id` | Restrict to a specific workspace | `https://api.trilo.chat/mcp?workspace_id=abc-123` |
| `read_only` | Force read-only mode | `https://api.trilo.chat/mcp?read_only=true` |
## Token Management
* **View tokens:** Profile Settings > API shows all your active tokens with last-used dates
* **Revoke a token:** Click the revoke button next to any token to immediately disable it
* **Multiple tokens:** Create separate tokens per client or machine for easy revocation
Create separate tokens for each AI tool or machine. If one is compromised, you can revoke it without affecting your other tools.
## Troubleshooting
* Verify your token starts with `trilo_pat_` and is copied correctly
* Check that the `Authorization` header uses the `Bearer` prefix
* Confirm the token hasn't been revoked in **Profile Settings** > **API**
Your token was created without MCP scopes. Create a new token and select at least `mcp:read`.
MCP sessions expire after 30 minutes of inactivity. Most clients reconnect automatically. If not, restart the MCP connection in your client.
You're making too many requests. Wait for the duration specified in the `Retry-After` header. Rate limits are per-user, not per-token.
Either your token only has `mcp:read` scope, or the `read_only=true` query parameter is set. Create a new token with `mcp:write` scope or remove the query parameter.
# Windsurf
Source: https://docs.trilo.chat/developers/mcp/clients/windsurf
Set up Trilo's MCP server in Windsurf with Personal Access Token authentication
[Windsurf](https://windsurf.com) is an AI-powered code editor. Connect it to Trilo via MCP to manage your workspace directly from the editor.
Windsurf uses `serverUrl` instead of `url` in its MCP config — make sure to use the correct field name.
## Setup
In Trilo, go to **Profile Settings** > **API** > **Create Token**. Select the scopes you need (`mcp:read`, `mcp:write`) and copy the token.
Choose one of these options:
**Option A — Settings UI:**
1. Open **Windsurf Settings** > **Cascade** > **MCP Servers** (or click the **MCPs** icon in the Cascade panel)
2. Click **Configure** to add a new server
3. Set the URL to `https://api.trilo.chat/mcp`
4. Add the Authorization header with your PAT
**Option B — Config file:**
Edit `~/.codeium/windsurf/mcp_config.json`:
```json theme={null}
{
"mcpServers": {
"trilo": {
"serverUrl": "https://api.trilo.chat/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
```
Replace `YOUR_TOKEN_HERE` with the PAT you copied.
You can use environment variables in the config: `"Authorization": "Bearer ${env:TRILO_PAT}"` to avoid hardcoding your token.
In Windsurf's AI chat, ask:
```
List my Trilo workspaces
```
If it returns your workspace data, you're connected.
## Options
Append query parameters to the MCP URL for additional control:
| Parameter | Description | Example |
| -------------- | -------------------------------- | ------------------------------------------------- |
| `workspace_id` | Restrict to a specific workspace | `https://api.trilo.chat/mcp?workspace_id=abc-123` |
| `read_only` | Force read-only mode | `https://api.trilo.chat/mcp?read_only=true` |
## Troubleshooting
* Verify your token starts with `trilo_pat_`
* Check the `Authorization` header uses the `Bearer` prefix
* Confirm the token hasn't been revoked in **Profile Settings** > **API**
Restart Windsurf after adding the MCP server. Verify you used `serverUrl` (not `url`) in the config, and that the URL is exactly `https://api.trilo.chat/mcp` with no trailing slash.
MCP sessions expire after 30 minutes of inactivity. Windsurf usually reconnects automatically. If not, restart the editor.
# Overview
Source: https://docs.trilo.chat/developers/mcp/overview
Connect AI coding tools like Claude Code, Cursor, and Windsurf to your Trilo workspace using the Model Context Protocol (MCP)
The [Model Context Protocol (MCP)](https://modelcontextprotocol.io) is an open standard that lets AI tools interact with external services. Trilo's MCP server gives your AI coding assistant direct access to your workspace — create tasks, read pages, send messages, and more without leaving your editor.
## What You Can Do
Once connected, your AI tool can interact with your entire Trilo workspace:
| Category | Example Prompts |
| ------------------ | ----------------------------------------------------------------------------------- |
| **Tasks** | "Create a bug report for the login issue" / "What tasks are assigned to me?" |
| **Pages** | "Write an implementation plan and save it as a page" / "Update the API docs page" |
| **Messages** | "Send a status update to the backend channel" / "What did the team discuss today?" |
| **Calendar** | "Schedule a design review for Friday at 2pm" / "What meetings do I have this week?" |
| **Meetings** | "Summarize the standup transcript" / "Search meetings for discussion about auth" |
| **Spreadsheets** | "Create a sprint tracking spreadsheet" / "Update the budget numbers" |
| **Members** | "Who's on the mobile project?" / "Add Sarah to the backend project" |
| **Knowledge Base** | "Search our docs for the deployment guide" / "Find resources about onboarding" |
## Supported AI Clients
Choose your AI tool to get started:
Anthropic's CLI tool. Supports **OAuth** and PAT authentication.
Anthropic's desktop app. Supports **OAuth** and PAT authentication.
AI-powered editor. Configure via Settings UI or config file.
AI-powered editor. Configure via Settings UI or config file.
Google's AI coding agent. Configure via MCP Store.
Any MCP-compatible tool using HTTP transport.
## Authentication
Trilo supports two authentication methods for MCP connections:
| Method | Best For | Setup |
| ------------------------------- | --------------------------- | ------------------------------------------------ |
| **OAuth 2.1** | Claude Code, Claude Desktop | Authorize in your browser — no token needed |
| **Personal Access Token (PAT)** | All clients, CI/CD, scripts | Generate in Trilo settings, pass as Bearer token |
**Use OAuth when available.** It's more secure (no token to manage) and easier to set up. Claude Code and Claude Desktop both support OAuth natively.
## Token Scopes
When creating a PAT, you choose which scopes to grant:
| Scope | Permissions |
| ----------- | ----------------------------------------------------------------------------------------------------------------- |
| `mcp:read` | List and read workspaces, projects, tasks, pages, messages, members, events, meetings, resources, spreadsheets |
| `mcp:write` | Everything in `mcp:read` plus create and update tasks, pages, messages, events, spreadsheets, and project members |
| `mcp:admin` | Everything in `mcp:write` plus administrative operations |
For most development workflows, `mcp:read` and `mcp:write` together provide full access to all tools. Use `mcp:read` alone if you only want your AI tool to read data without making changes.
## Next Steps
Browse all 40+ available MCP tools.
# Quickstart
Source: https://docs.trilo.chat/developers/mcp/quickstart
Step-by-step guide to connect Claude Code, Cursor, Windsurf, Google Antigravity, or any MCP client to your Trilo workspace
Get your AI coding tool connected to Trilo in a few minutes. Choose your client below for a step-by-step setup guide.
## Choose Your AI Client
**Recommended** — one command with OAuth, no token needed.
OAuth setup via config file — no token needed.
Configure via Settings UI or `.cursor/mcp.json`.
Configure via Settings UI or config file.
Configure via MCP Store raw config.
Any MCP-compatible tool using HTTP transport.
## How It Works
Trilo's MCP server exposes 40+ tools that let your AI tool interact with your workspace. Here's the quick version:
1. **Connect** — Add Trilo's MCP server to your AI client (OAuth or PAT)
2. **Authorize** — Grant access via browser (OAuth) or paste your token (PAT)
3. **Use** — Ask your AI tool to interact with Trilo: create tasks, read pages, send messages, and more
The server endpoint is:
```
https://api.trilo.chat/mcp
```
## Authentication Methods
| Method | Clients | How It Works |
| ------------- | --------------------------- | ----------------------------------------------------------------------- |
| **OAuth 2.1** | Claude Code, Claude Desktop | Authorize in your browser — no token to manage |
| **PAT** | All clients | Create a token in **Profile Settings** > **API**, pass as Bearer header |
**Use OAuth when your client supports it.** It's more secure and easier to manage — no tokens to store or rotate.
## Need Help?
If you run into issues, check the troubleshooting section on your client's setup page, or reach out at [support@trilo.chat](mailto:support@trilo.chat).
# Tools Reference
Source: https://docs.trilo.chat/developers/mcp/tools-reference
Complete reference of all MCP tools available in Trilo, organized by entity
All tools available through Trilo's MCP server, organized by entity. Each tool requires a valid [Personal Access Token](/developers/mcp/quickstart) or OAuth session.
**Scope key:** Read tools require `mcp:read`. Write tools require `mcp:write` (which also grants read access).
## Workspaces
| Tool | Scope | Description |
| ----------------- | ----- | -------------------------------------------------------- |
| `list_workspaces` | Read | List all workspaces the authenticated user has access to |
| `get_workspace` | Read | Get details for a specific workspace by ID |
## Areas
| Tool | Scope | Description |
| ------------ | ----- | --------------------------------------------------------------------- |
| `list_areas` | Read | List all areas accessible to the user in a workspace |
| `get_area` | Read | Get detailed information about a specific area including its projects |
## Projects
| Tool | Scope | Description |
| --------------- | ----- | ------------------------------------------------------- |
| `list_projects` | Read | List all projects accessible to the user in a workspace |
| `get_project` | Read | Get detailed information about a specific project |
## Tasks
| Tool | Scope | Description |
| ------------- | ----- | ---------------------------------------------------------------------------------------------- |
| `list_tasks` | Read | List tasks with optional filters (project, status, assignee, priority, due date, search query) |
| `get_task` | Read | Get detailed information about a specific task including activity history |
| `create_task` | Write | Create a new task in a project |
| `update_task` | Write | Update fields on an existing task (title, status, priority, assignee, due date, project) |
Use `list_tasks` with the `query` parameter to search by task title or custom ID (e.g., "MVP-123"). Combine filters like `status`, `priority`, and `assignedToWorkspaceHumanMemberId` to narrow results.
## Messages
| Tool | Scope | Description |
| --------------- | ----- | ----------------------------------------------------------------------------- |
| `list_messages` | Read | List messages in a project channel |
| `get_message` | Read | Get a single message with author info, reactions, and timestamps |
| `send_message` | Write | Send a message to a project channel (supports replies via `replyToMessageId`) |
## Pages
Pages have the richest tool set, supporting structured content editing:
| Tool | Scope | Description |
| ------------------------------- | ----- | ------------------------------------------------------------------------------------ |
| `list_pages` | Read | List pages in a workspace, optionally filtered by project |
| `get_page` | Read | Get detailed information about a specific page including its content |
| `create_page` | Write | Create a new page in the workspace (markdown content) |
| `update_page` | Write | Update an existing page's title or content |
| `pages_get_structure` | Read | Get the structure of a page with block references for precise editing |
| `pages_get_content` | Read | Get the full content of a page as markdown |
| `pages_insert_content` | Write | Insert content at a specific position in a page |
| `pages_append_content` | Write | Append content to the end of a page |
| `pages_replace_content` | Write | Find and replace text in a page |
| `pages_delete_content` | Write | Delete content from a page by block selector or range |
| `pages_insert_entity_reference` | Write | Insert a mention chip (page, task, member, board, spreadsheet, or project reference) |
For precise page edits, call `pages_get_structure` first to get block references like `[b0]`, `[b1]`, then use `pages_insert_content` or `pages_delete_content` with those references.
## Members
| Tool | Scope | Description |
| -------------------- | ----- | ---------------------------------------------------------- |
| `list_members` | Read | List all members (humans and AI coworkers) in a workspace |
| `get_member` | Read | Get detailed information about a specific workspace member |
| `get_current_user` | Read | Get the authenticated user's information |
| `get_current_member` | Read | Get the authenticated user's workspace member record |
## Calendar Events
| Tool | Scope | Description |
| -------------- | ----- | ----------------------------------------------------------------------- |
| `list_events` | Read | List events in a workspace with optional date range and project filters |
| `create_event` | Write | Create a new calendar event (supports all-day events) |
| `update_event` | Write | Update an existing calendar event |
## Meetings
| Tool | Scope | Description |
| --------------------------- | ----- | ----------------------------------------------------------- |
| `list_meetings` | Read | List meetings in a workspace or project |
| `get_meeting_transcription` | Read | Get the full speaker-attributed transcription for a meeting |
| `search_transcriptions` | Read | Search across all meeting transcriptions for keywords |
## Knowledge Base Resources
| Tool | Scope | Description |
| ---------------------- | ----- | --------------------------------------------------------------------- |
| `search_resources` | Read | Search knowledge base resources (attachments, pages, pinned messages) |
| `get_resource_content` | Read | Get the full content of a specific resource |
## Spreadsheets
| Tool | Scope | Description |
| -------------------- | ----- | --------------------------------------------------------------------------------------------------- |
| `list_spreadsheets` | Read | List spreadsheets in a workspace or project |
| `get_spreadsheet` | Read | Get detailed information about a specific spreadsheet including its content (headers and data rows) |
| `create_spreadsheet` | Write | Create a new spreadsheet with optional headers and initial data |
| `update_spreadsheet` | Write | Update an existing spreadsheet's headers and data |
## Project Members
| Tool | Scope | Description |
| ---------------------------- | ----- | ----------------------------------------------------------- |
| `list_project_members` | Read | List all members of a specific project |
| `add_project_member` | Write | Add workspace members (human or AI) to a project |
| `remove_project_member` | Write | Remove a member from a project |
| `update_project_member_role` | Write | Update a human project member's role (owner, admin, member) |
## Tool Count Summary
| Category | Read | Write | Total |
| --------------- | ------ | ------ | ------ |
| Workspaces | 2 | 0 | 2 |
| Areas | 2 | 0 | 2 |
| Projects | 2 | 0 | 2 |
| Tasks | 2 | 2 | 4 |
| Messages | 2 | 1 | 3 |
| Pages | 3 | 8 | 11 |
| Members | 4 | 0 | 4 |
| Calendar Events | 1 | 2 | 3 |
| Meetings | 3 | 0 | 3 |
| Knowledge Base | 2 | 0 | 2 |
| Spreadsheets | 2 | 2 | 4 |
| Project Members | 1 | 3 | 4 |
| **Total** | **26** | **18** | **44** |
# Download Apps
Source: https://docs.trilo.chat/getting-started/download-apps
Get Trilo on your desktop and mobile devices for the best experience
Trilo is available on all major platforms. While you can always use Trilo in your web browser, our native apps provide a faster, more integrated experience.
## Desktop Apps
Our desktop apps offer native performance, system notifications, and seamless integration with your operating system.
**Requirements**: macOS 11 (Big Sur) or later
[Download for Mac](https://trilo.chat/download)
Also available on the Mac App Store.
**Requirements**: Windows 10 or later
[Download for Windows](https://trilo.chat/download)
### Desktop App Features
The desktop app includes everything in the web version, plus:
* **Native notifications**: Get system notifications for messages, task assignments, and calendar events
* **Quick access**: Launch Trilo from your dock or taskbar
* **Keyboard shortcuts**: Full keyboard navigation optimized for your OS
* **Offline indicator**: Clear indication when you're offline
* **Deep linking**: Open Trilo links directly in the app
### Installing the Desktop App
Click the download link above or visit [trilo.chat/download](https://trilo.chat/download).
Double-click the downloaded `.dmg` file to open it.
Drag the Trilo icon to your Applications folder.
Open Trilo from your Applications folder or Spotlight search.
Enter your credentials or sign in with Google to access your workspace.
On first launch, macOS may ask you to confirm opening an app from the internet. Click **Open** to proceed.
Click the download link above to get the Windows installer.
Double-click the downloaded `.exe` file to start installation.
Click through the installation wizard to complete setup.
Trilo will launch automatically, or you can find it in the Start menu.
Enter your credentials to access your workspace.
## Mobile Apps
Take Trilo with you on your phone or tablet. Our mobile apps are optimized for on-the-go productivity.
**Requirements**: iOS 15 or later
Coming soon to the App Store.
Works on iPhone and iPad.
**Requirements**: Android 10 or later
Coming soon to Google Play.
### Mobile App Features
The mobile apps let you stay connected wherever you are:
* **Chat and messaging**: Send and receive messages in real-time
* **View and edit resources**: Access your knowledge base on the go
* **Task management**: Check off tasks and update statuses
* **Calendar access**: View your schedule and upcoming events
* **Push notifications**: Stay informed about important updates
* **AI conversations**: Chat with AI coworkers from anywhere
### Mobile-Optimized Experience
Our mobile apps aren't just smaller versions of the desktop app—they're designed specifically for mobile use:
* **Touch-optimized interface**: Easy navigation with swipe gestures
* **Quick actions**: Common actions are always within reach
* **Offline support**: Draft messages even without internet connection
* **Dark mode**: Automatic switching based on your device settings
## Web App
No installation required—access Trilo directly in your browser.
Works best in Chrome, Firefox, Safari, and Edge.
### Supported Browsers
* **Google Chrome** (recommended): Version 90 or later
* **Mozilla Firefox**: Version 90 or later
* **Safari**: Version 14 or later
* **Microsoft Edge**: Version 90 or later
Internet Explorer is not supported. For the best experience, please use a modern browser.
## Staying in Sync
Your data automatically syncs across all your devices:
* Changes made on any device appear everywhere instantly
* Messages, tasks, and documents are always up to date
* No manual syncing required
If you're having sync issues, try signing out and back in, or check your internet connection.
## Auto-Updates
Our desktop and mobile apps update automatically to ensure you always have the latest features and security improvements.
* **Desktop**: Updates are downloaded in the background and applied when you restart the app
* **Mobile**: Enable automatic updates in your device's app store settings
## Troubleshooting
Try these steps:
1. Restart your computer
2. Re-download the latest version from our website
3. Check that your OS meets the minimum requirements
4. On Mac, try right-clicking and selecting "Open" if you see a security warning
Make sure notifications are enabled:
* **Desktop**: Check your system notification settings
* **Mobile**: Go to Settings > Apps > Trilo > Notifications
* **In-app**: Check Settings > Notifications in Trilo
Try these solutions:
1. Close and reopen the app
2. Check your internet connection
3. Update to the latest version
4. Clear the app cache in your device settings
## Need Help?
Having trouble with installation? Contact us:
* **Email**: [support@trilo.chat](mailto:support@trilo.chat)
* **Community**: [Discord](https://discord.gg/trilo)
## Next Steps
Once you've installed Trilo, explore these features:
Set up your first workspace and project.
Work with multiple panels side-by-side.
Get help from AI assistants.
Configure how you receive alerts.
# Welcome to Trilo
Source: https://docs.trilo.chat/getting-started/introduction
Your all-in-one workspace for team collaboration, knowledge management, and AI-powered productivity
## What is Trilo?
Trilo is a comprehensive collaboration platform that brings together everything your team needs to work effectively. Combine your knowledge base, tasks, calendar, and team communication in one unified workspace—with AI coworkers to help you get more done.
Create and organize documents, spreadsheets, and whiteboards in one place.
Manage work with powerful task tracking, assignments, and multiple views.
Schedule events, sync with Google Calendar, and set up booking pages.
Communicate in real-time with project channels and direct messages.
## Why Teams Choose Trilo
### Everything in One Place
Stop switching between apps. Trilo combines your documentation, project management, scheduling, and communication into a single, cohesive workspace.
### AI-Powered Productivity
Work alongside AI coworkers that can help you draft content, analyze data, manage tasks, and more. They're integrated directly into your workflow, not bolted on as an afterthought.
### Real-Time Collaboration
Edit documents together, see who's online, and communicate instantly. Every change syncs in real-time across all devices.
### Organized by Design
Use workspaces, areas, and projects to create a structure that matches how your team actually works. Find what you need, when you need it.
## Core Concepts
Understanding these key concepts will help you get the most out of Trilo:
A workspace is your team's home base. It contains all your projects, resources, and team members. Most teams have one workspace, but you can create multiple for different organizations or clients.
Areas are top-level categories within your workspace. Use them to organize projects by department, team, or initiative. For example: "Engineering," "Marketing," or "Q1 Launch."
Projects live within areas and contain your actual work—tasks, knowledge base resources, calendar events, and chat messages. Each project has its own channel and settings.
Resources are the content you create in your knowledge base. This includes pages (documents), spreadsheets, and boards (whiteboards). Resources can be organized within projects or shared across your workspace.
AI coworkers are intelligent assistants that can help with various tasks. You can chat with them, assign them work, and even create custom coworkers tailored to your team's needs.
## Getting Started
Ready to dive in? Here's how to get started:
Sign up at [app.trilo.chat](https://app.trilo.chat) with your email or Google account.
Create your first workspace and invite your team members.
Set up a project within an area to start organizing your work.
Try creating a document, adding tasks, or chatting with an AI coworker.
Follow our step-by-step quickstart to set up your workspace in minutes.
## Platform Availability
Trilo is available on:
* **Web**: Access from any modern browser at [app.trilo.chat](https://app.trilo.chat)
* **Desktop**: Native apps for macOS and Windows
* **Mobile**: iOS and Android apps for work on the go
Get Trilo on all your devices.
## Explore Trilo Features
Dive deeper into what Trilo can do for your team:
Create docs, spreadsheets, and whiteboards.
Track work with multiple views and AI assistance.
Schedule events and sync external calendars.
Communicate with channels, DMs, and voice calls.
Get help from intelligent AI assistants.
Connect 100+ apps like GitHub, Slack, and Gmail.
# Quick Start Guide
Source: https://docs.trilo.chat/getting-started/quickstart
Get your team up and running with Trilo in just a few minutes
This guide will walk you through setting up your Trilo workspace and getting your team started. You'll be up and running in about 10 minutes.
## Step 1: Create Your Account
Go to [app.trilo.chat](https://app.trilo.chat) in your web browser.
Click **Get Started** and create your account using:
* Your email address and a password, or
* Sign in with Google for quick access
If you signed up with email, check your inbox and click the verification link.
## Step 2: Create Your Workspace
After signing in, you'll be prompted to create your first workspace.
Choose a name that represents your team or organization (e.g., "Acme Inc" or "Marketing Team").
Pick a unique URL for your workspace. This will be used when sharing links and accessing your workspace directly.
Upload your company or team logo to personalize your workspace.
You can always change your workspace name, URL, and logo later in **Settings > Workspace**.
## Step 3: Invite Your Team
Collaboration is better with your team. Here's how to invite them:
Click on **Settings** in the sidebar, then select **Members**.
Enter the email addresses of team members you want to invite. They'll receive an email with a link to join your workspace.
Choose whether to invite members as:
* **Admin**: Can manage workspace settings and members
* **Member**: Can create and edit content
* **Guest**: Limited access to specific projects
Invited members can join immediately—no approval needed. They'll have access to all projects unless you've configured specific permissions.
## Step 4: Set Up Your First Project
Projects are where your actual work happens. Let's create one:
In the sidebar, click the **+** button next to **Areas** and name your first area (e.g., "Product Development" or "Client Projects").
Within your new area, click **+ New Project**. Give it a name and optional description.
* **Project Prefix**: A short code used for task IDs (e.g., "PROD" makes tasks like PROD-1, PROD-2)
* **Enable AI features**: Toggle whether AI coworkers can assist in this project
* **Project visibility**: Choose who can see this project
## Step 5: Explore the Features
Now that your workspace is set up, try out the core features:
### Create a Document
In your project, click on **Resources** in the navigation.
Click **+ New** and select **Page**.
Use the rich text editor to add content. Try using `/` commands to add headings, lists, images, and more.
### Add a Task
Click on **Tasks** in your project navigation.
Click **+ New Task** or press `T` for a quick shortcut.
Add a title, description, assign it to a team member, set a due date, and choose a priority.
### Chat with Your Team
Every project has a built-in chat channel. Click on **Chat** in your project.
Type your message and press Enter. Use `@` to mention team members.
Click on **AI Coworkers** in the sidebar to start a conversation with an AI assistant.
### Schedule an Event
Click on **Calendar** in the main navigation.
Click on a time slot or press **+ New Event**.
Set the title, time, location (physical or virtual), and invite participants.
## What's Next?
You've got the basics down! Here are some next steps to explore:
Learn about pages, spreadsheets, and whiteboards.
Master task views, filters, and workflows.
Discover how AI can boost your productivity.
Set up roles and permissions for your team.
## Need Help?
* **In-app support**: Click the help icon in the bottom-left corner
* **Community**: Join our [Discord community](https://discord.gg/trilo) to connect with other users
* **Email**: Reach out to [support@trilo.chat](mailto:support@trilo.chat) for direct assistance
# Split View
Source: https://docs.trilo.chat/getting-started/split-view
Work with multiple panels side-by-side for faster context switching
Split view lets you see multiple things at once—a chat and a page, two documents side by side, or whatever combination works for you. Instead of constantly switching tabs, keep everything visible.
## Opening split view
Split view activates automatically when you open something in a new panel. Here's how:
### From resources
1. Browse to a page, board, or spreadsheet in your project's Resources
2. Hold **Cmd** (Mac) or **Ctrl** (Windows) and click the item
3. It opens in a new panel to the right
Or:
1. Right-click any resource
2. Select **Open in new panel**
### From chat
When you're in a project chat or DM and want to reference a document:
1. Click the **+** button to add a resource
2. The resource opens alongside your chat
### From the panel menu
Click the **...** menu in any panel header and select **Split right** to duplicate the panel.
## Working with panels
### Resizing
Drag the divider between panels to adjust their widths. Each panel has a minimum size, so you can't shrink them to nothing.
### Switching focus
Click anywhere in a panel to make it active. The active panel has a subtle highlight.
### Closing a panel
Click the **X** in a panel's header, or use the **...** menu and select **Close panel**.
When you close the last extra panel, you're back to single-panel mode.
## Drag and drop
When you have multiple panels open, you can drag resources between them:
1. Click and hold on a resource (in a list, grid, or table)
2. Drag it to another panel
3. Drop it to open it there
Drag and drop only works in split view. In single-panel mode, right-click or Cmd-click to open things.
This is handy when you're organizing—drag a document from a list into a chat panel to discuss it, or move things between projects.
## What works well in split view
Some common setups:
| Left panel | Right panel | Use case |
| ------------ | ------------ | ------------------------- |
| Project chat | Page editor | Discuss while editing |
| Task list | Task details | Review work quickly |
| Two pages | - | Compare documents |
| Chat | Calendar | Schedule while discussing |
| Kanban board | Task details | Drag tasks, see details |
## Responsive content
Panels adjust their content based on width. In a narrow panel, you might see a compact view; widen it and you'll see more detail. This happens automatically—content reorganizes itself as you resize.
## AI awareness
When you have a page open in split view while chatting with an AI coworker, the AI knows you can see the page. Instead of repeating everything it changes, the AI gives you brief confirmations since you're watching it work in real time.
## Keyboard shortcuts
| Action | Shortcut |
| ------------------- | ------------------------------------- |
| Open in new panel | **Cmd/Ctrl + Click** |
| Close current panel | **Cmd/Ctrl + W** (when panel focused) |
## Tips
The most common split view setup. Keep your AI coworker or team chat on the left, and work on pages or tasks on the right.
Open two versions of a page side by side to compare changes or merge content.
Keep your task list on one side and task details on the other. Click through tasks without losing your place in the list.
Cmd/Ctrl + Click is the fastest way to open things in split view. Right-clicking works too, but it's slower.
## Going back to single view
Just close the extra panels. Click the **X** on each one until you're back to a single panel. Your workspace remembers your preference, so split view won't randomly come back unless you open something in a new panel again.
## Next steps
Create and edit documents.
Manage your team's work.
# AI Productivity Tips
Source: https://docs.trilo.chat/guides/ai-productivity-tips
Get the most out of AI coworkers to boost your productivity
AI coworkers can significantly boost your productivity when used effectively. This guide shares strategies and tips for getting maximum value from AI assistance in Trilo.
## Getting Started with AI
### Your First AI Interactions
Start with simple, common tasks:
1. **Ask questions**: "What's the best way to..."
2. **Get explanations**: "Explain \[concept] simply"
3. **Summarize content**: "Summarize this document"
4. **Draft content**: "Write a brief email about..."
### Building Comfort
As you get comfortable, try more complex tasks:
* Multi-step requests
* Creative brainstorming
* Analysis and recommendations
* Content editing and improvement
## High-Impact Use Cases
### Daily Productivity
**Morning planning:**
```
"Help me prioritize these tasks for today:
[list your tasks]
Consider deadlines and importance."
```
**Email drafting:**
```
"Write a professional email to [recipient] about [topic].
Include: [key points].
Tone: [professional/friendly/formal]"
```
**Meeting prep:**
```
"I have a meeting about [topic] in an hour.
Create an agenda with key discussion points and
questions I should ask."
```
### Writing and Content
**Document drafting:**
```
"Create an outline for a document about [topic].
Audience: [who will read it]
Purpose: [what it should accomplish]"
```
**Editing and improving:**
```
"Review this text and suggest improvements for:
1. Clarity
2. Conciseness
3. Professional tone
[paste your text]"
```
**Creative content:**
```
"Brainstorm 10 headlines for our blog post about [topic].
Target audience: [audience description]
Tone: [desired tone]"
```
### Analysis and Research
**Data interpretation:**
```
"I have this data: [paste data]
What patterns or insights do you see?
What recommendations would you make?"
```
**Competitive analysis:**
```
"Compare these two approaches: [A] vs [B]
List pros and cons of each.
Make a recommendation based on [criteria]."
```
**Problem solving:**
```
"We're facing this challenge: [describe problem]
What are possible solutions?
What are the tradeoffs of each?"
```
### Technical Tasks
**Code help:**
```
"Explain how to implement [feature] in [language].
Include a basic code example."
```
**Documentation:**
```
"Write documentation for this function:
[paste code]
Include: purpose, parameters, return value, example usage."
```
**Debugging:**
```
"I'm getting this error: [error message]
Here's my code: [paste code]
What's causing this and how do I fix it?"
```
## Effective Prompting
### The CONTEXT Framework
Structure your requests for better results:
* **C**ontext: Background information
* **O**bjective: What you want to achieve
* **N**uances: Specific requirements
* **T**one: Desired style
* **E**xamples: What good looks like
* **X**tra: Any constraints
**Example:**
```
Context: I'm a product manager preparing a quarterly review.
Objective: Create a presentation outline.
Nuances: Focus on metrics and achievements, not excuses.
Tone: Confident but honest.
Example: Previous quarters used 5 sections with 3-4 slides each.
Extra: Keep it under 20 slides total.
```
### Specificity Matters
**Vague (less helpful):**
```
"Write something about our product."
```
**Specific (more helpful):**
```
"Write a 150-word product description for our project management app.
Target audience: Small business owners
Key features to highlight: Task tracking, team collaboration, mobile app
Tone: Professional but friendly
Call to action: Start free trial"
```
### Iterate and Refine
Don't expect perfection on the first try:
```
You: Write a tagline for our productivity app.
AI: "Work smarter, not harder."
You: That's too generic. Focus on our AI features.
AI: "Your AI-powered productivity partner."
You: Better! Can you make it more action-oriented?
AI: "Supercharge your workflow with AI assistance."
You: Perfect!
```
## Workflow Integration
### Daily Workflows
**Morning routine:**
1. Check tasks, ask AI to help prioritize
2. Draft any emails needed
3. Prepare for meetings
**During work:**
1. Use AI for quick research
2. Get drafts for content
3. Brainstorm solutions to problems
**End of day:**
1. Summarize accomplishments
2. Plan for tomorrow
3. Draft status updates
### Project Workflows
**Starting a project:**
* Generate project plan outline
* Create initial task list
* Draft project brief
**During a project:**
* Get help with content creation
* Analyze progress and blockers
* Prepare status updates
**Completing a project:**
* Summarize outcomes
* Document lessons learned
* Draft announcements
## Advanced Techniques
### Chain of Thought
For complex problems, ask AI to think step-by-step:
```
"I need to decide between two vendors.
Walk me through this step by step:
1. What criteria should I consider?
2. How should I weight each criterion?
3. Apply this to: Vendor A [details] vs Vendor B [details]
4. Make a recommendation"
```
### Role Assignment
Give the AI a specific role:
```
"Act as an experienced marketing strategist.
Review our current approach and suggest improvements.
[details]"
```
### Multiple Perspectives
Get different viewpoints:
```
"For this decision, give me:
1. The optimistic perspective
2. The pessimistic perspective
3. The pragmatic recommendation
[describe the decision]"
```
### Feedback Loops
Build on previous responses:
```
Conversation 1: Get initial draft
Conversation 2: Refine specific sections
Conversation 3: Polish and finalize
```
## When to Use AI (and When Not To)
### Great for AI
| Task | Why It Works |
| ------------- | ---------------------------------- |
| First drafts | AI gets you started, you refine |
| Brainstorming | AI generates options quickly |
| Summarizing | AI extracts key points efficiently |
| Explaining | AI can simplify complex topics |
| Formatting | AI restructures content well |
### Better for Humans
| Task | Why |
| ----------------------- | ------------------------------- |
| Final decisions | Judgment and accountability |
| Sensitive communication | Nuance and relationships |
| Original strategy | Business context and creativity |
| Confidential matters | Privacy considerations |
| Critical accuracy | Verification needed |
### Always Review
AI outputs should always be reviewed:
* Check facts and accuracy
* Verify tone is appropriate
* Ensure content fits your context
* Add personal touches
## Productivity Multipliers
### Templates with AI
Create templates, then use AI to fill them:
```
"Fill in this template with information about [project]:
## Overview
[Brief description]
## Goals
[3-5 goals]
## Timeline
[Key milestones]
## Risks
[Potential challenges]"
```
### Batch Processing
Group similar tasks:
```
"I need to write thank-you notes to these people.
Create a personalized paragraph for each:
1. Sarah - helped with the presentation
2. Mike - covered my meetings last week
3. Lisa - gave great feedback on the proposal"
```
### Learning and Growth
Use AI to learn faster:
```
"I'm trying to improve at [skill].
1. What are the key concepts I should understand?
2. What's a good practice exercise?
3. What common mistakes should I avoid?"
```
## Common Pitfalls
AI is a tool, not a replacement. Use it to enhance your work, not do all your thinking.
Always review AI outputs before using them. Errors and inaccuracies happen.
Specific requests get better results. Include context, constraints, and examples.
First responses are rarely perfect. Build on them through conversation.
Don't share confidential information with AI unnecessarily.
## Building AI Habits
### Start Small
Pick one daily task to enhance with AI:
* Email drafting
* Meeting prep
* Content summarization
### Track What Works
Note when AI helps most:
* What types of requests work well
* Which prompts get best results
* Where AI saves the most time
### Share with Team
Help others learn:
* Share effective prompts
* Document useful workflows
* Create team AI guidelines
## Next Steps
Learn more about AI coworker capabilities.
Master AI conversation techniques.
# Onboarding Your Team
Source: https://docs.trilo.chat/guides/onboarding-your-team
A complete guide to getting your team up and running with Trilo
Successfully onboarding your team to Trilo ensures everyone gets value from the platform quickly. This guide walks you through the entire process from setup to adoption.
## Preparation Phase
### Before You Begin
Gather information you'll need:
* [ ] Team member list and email addresses
* [ ] Organizational structure (who works on what)
* [ ] Current tools and workflows to replace/integrate
* [ ] Key projects and ongoing work
* [ ] Any specific requirements or concerns
### Plan Your Structure
Design your workspace organization:
List the high-level categories (departments, teams, or initiatives).
Identify projects within each area.
Decide who needs access to what.
Establish naming conventions and usage guidelines.
**Example structure:**
```
Workspace: Acme Inc
├── Engineering
│ ├── Platform Development
│ └── Mobile App
├── Marketing
│ ├── Content
│ └── Campaigns
└── Operations
└── Company Initiatives
```
## Setting Up Your Workspace
### Step 1: Create the Structure
If you haven't already, create your workspace with a clear name.
Create areas based on your organizational plan.
Add key projects to each area.
Set prefixes, descriptions, and basic settings.
### Step 2: Prepare Content
Before inviting your team, prepare some initial content:
* **Welcome document**: Create a page explaining how your team uses Trilo
* **Guidelines**: Document your conventions and best practices
* **Templates**: Create templates for common document types
* **Sample tasks**: Add some initial tasks to demonstrate the workflow
### Step 3: Configure Settings
Set up workspace-level settings:
* [ ] Workspace name and logo
* [ ] Default timezone
* [ ] Security settings (2FA requirements if needed)
* [ ] Integration connections (calendars, etc.)
## Inviting Your Team
### Invitation Strategy
Don't invite everyone at once. Use a phased approach:
**Phase 1: Core Team**
* Invite key team members first
* Get feedback on structure and settings
* Adjust based on input
**Phase 2: Extended Team**
* Invite remaining team members
* Core team can help with questions
* Scale more confidently
### Sending Invitations
Navigate to member management.
Organize by role (Admin, Member, Guest).
Invite batch by batch with appropriate roles.
Ensure everyone accepts their invitation.
### Role Assignment
Assign roles thoughtfully:
| Role | Assign To |
| ---------- | -------------------------------------- |
| **Admin** | Team leads who need to manage settings |
| **Member** | Regular team members |
| **Guest** | External collaborators |
## Introducing Trilo to Your Team
### Kickoff Communication
Send an announcement explaining:
* Why you're adopting Trilo
* What it replaces (if anything)
* Timeline for transition
* Where to get help
**Example email:**
```
Subject: Welcome to Trilo - Our New Team Workspace
Hi team,
We're excited to introduce Trilo as our new collaboration platform.
You'll receive an invitation to join our workspace shortly.
What Trilo includes:
- Knowledge base for documentation
- Task management
- Team chat and messaging
- Calendar and scheduling
- AI assistants to help with work
Getting started:
1. Accept your email invitation
2. Set up your profile
3. Explore the workspace
4. Check out the "Welcome to Trilo" page
Questions? Reach out to [contact person].
Looking forward to collaborating better together!
```
### Kickoff Meeting
Host a brief session to introduce Trilo:
**Agenda:**
1. Why Trilo (5 min)
2. Tour of the workspace (10 min)
3. Key features overview (10 min)
4. Q\&A (10 min)
5. Next steps (5 min)
## Training Your Team
### Self-Service Resources
Point your team to:
* This documentation
* Your internal "Welcome" page
* Video tutorials (if available)
* Quick reference guides
### Essential Training Topics
Ensure everyone understands:
| Feature | Key Points |
| -------------- | ----------------------------- |
| **Navigation** | Sidebar, projects, areas |
| **Tasks** | Creating, assigning, updating |
| **Chat** | Channels, DMs, mentions |
| **Resources** | Pages, search, organization |
| **AI** | How to chat with AI coworkers |
### Role-Specific Training
**For Admins:**
* Member management
* Settings configuration
* Project setup
**For Power Users:**
* Advanced features
* Integrations
* Templates and automation
## Migrating Existing Work
### Content Migration
Bring existing content into Trilo:
Focus on active, frequently-used content first.
Copy or recreate important documents as Trilo pages.
Import or recreate ongoing task lists.
Once migrated, archive (don't delete) old content.
### Timeline for Transition
Create a realistic transition plan:
| Week | Focus |
| ---- | ------------------------------------- |
| 1 | Setup and core team onboarding |
| 2 | Full team invitation and training |
| 3 | Active migration and parallel running |
| 4 | Primary usage, resolve issues |
| 5+ | Full adoption, retire old tools |
## Driving Adoption
### Quick Wins
Help your team experience value quickly:
* Start using chat immediately
* Create their first task
* Edit a document collaboratively
* Try asking an AI coworker a question
### Champions Program
Identify "champions" on your team:
* Power users who learn quickly
* Enthusiastic about new tools
* Willing to help others
Champions can:
* Answer basic questions
* Share tips and tricks
* Provide feedback on issues
### Regular Check-ins
During the first month:
* Weekly check-in on adoption progress
* Collect and address feedback
* Celebrate wins and usage milestones
* Identify struggling users and provide help
## Measuring Success
### Adoption Metrics
Track these indicators:
| Metric | Target |
| ------------------------- | --------------------------- |
| **Invitation acceptance** | 100% within first week |
| **Daily active users** | 80%+ of team |
| **Features used** | All core features by week 3 |
| **Old tool usage** | Declining to zero |
### Gathering Feedback
Collect feedback regularly:
* Short surveys at week 2 and week 4
* Open feedback channel in Trilo
* One-on-one conversations with key users
### Iterating
Use feedback to improve:
* Adjust workspace structure
* Update guidelines
* Add missing templates
* Address pain points
## Common Onboarding Challenges
* Clearly communicate the "why"
* Show benefits, not just features
* Start with willing adopters
* Address concerns directly
* Focus on essential features first
* Add complexity gradually
* Create simple getting-started guides
* Don't explain everything at once
* Lead by example
* Make Trilo the "source of truth"
* Stop using old tools for new work
* Gently redirect back to Trilo
* Set up notifications properly
* Include Trilo links in other communications
* Make checking Trilo part of daily routine
* Consider daily check-in reminders initially
## Onboarding Checklist
Use this checklist for your onboarding:
### Week Before Launch
* [ ] Workspace created and configured
* [ ] Structure defined (areas, projects)
* [ ] Welcome content created
* [ ] Admin roles assigned
* [ ] Kickoff communication drafted
### Launch Week
* [ ] Core team invited and onboarded
* [ ] Kickoff meeting held
* [ ] Basic training provided
* [ ] Feedback channel established
### Week After Launch
* [ ] Full team invited
* [ ] Migration started
* [ ] First check-in conducted
* [ ] Issues addressed
### One Month
* [ ] Adoption metrics reviewed
* [ ] Feedback collected
* [ ] Structure refined
* [ ] Old tools phased out
## Next Steps
Learn best practices for project organization.
Get the most out of AI coworkers.
# Organizing Projects
Source: https://docs.trilo.chat/guides/organizing-projects
Best practices for structuring and managing projects effectively
Well-organized projects help teams work efficiently and find information quickly. This guide covers strategies and best practices for project organization in Trilo.
## Project Organization Philosophy
### Principles
Good project organization follows these principles:
1. **Findability**: Anyone should find what they need quickly
2. **Consistency**: Similar things are organized the same way
3. **Scalability**: Structure works as the project grows
4. **Clarity**: Purpose and contents are obvious
### Questions to Ask
Before creating a project, consider:
* What work will happen here?
* Who needs access?
* How long will this project be active?
* What content types will it contain?
* How does it relate to other projects?
## Workspace Structure
### Organizing Areas
Areas are your top-level organization:
**By Department:**
```
├── Engineering
├── Marketing
├── Sales
├── Operations
└── Executive
```
**By Client:**
```
├── Internal
├── Client: Acme Corp
├── Client: Beta Industries
└── Client: Gamma Tech
```
**By Initiative:**
```
├── Product
├── Growth
├── Infrastructure
└── Culture
```
### Choosing the Right Structure
| Structure | Best For | Example |
| -------------- | ------------------------- | ---------------------- |
| **Department** | Functional teams | Engineering, Marketing |
| **Client** | Service businesses | Client projects |
| **Initiative** | Startups, project-focused | Quarterly goals |
| **Hybrid** | Complex organizations | Mix of above |
## Project Types
### Active Projects
Projects with ongoing work:
* Regular activity from team
* Active tasks and discussions
* Frequently updated resources
**Examples:**
* Product Development
* Marketing Campaigns
* Customer Support
### Reference Projects
Projects primarily for documentation:
* Less frequent updates
* Mostly knowledge base content
* Reference material
**Examples:**
* Company Handbook
* Brand Guidelines
* Technical Documentation
### Time-Bound Projects
Projects with defined start and end:
* Specific deliverable or goal
* Clear timeline
* Will be completed/archived
**Examples:**
* Q1 Product Launch
* Office Move
* Annual Conference
## Naming Conventions
### Project Names
Use clear, descriptive names:
**Good names:**
* "Mobile App Development"
* "Q1 2024 Marketing Campaign"
* "Customer Onboarding Process"
**Avoid:**
* "Project X"
* "Stuff"
* Abbreviations without context
### Prefixes
Choose meaningful task prefixes:
| Project | Good Prefix | Why |
| ---------------- | ----------- | --------------------- |
| Mobile App | `APP` | Clear, short |
| Marketing | `MKT` | Standard abbreviation |
| Backend API | `API` | Technical but clear |
| Customer Support | `SUP` | Recognizable |
### Consistency
Apply naming patterns consistently:
* Same format across similar projects
* Document your conventions
* Train new team members
## Within-Project Organization
### Task Organization
Organize tasks effectively:
**By Status:**
* Use the built-in statuses (Backlog, To Do, In Progress, Done)
* Keep backlog for future ideas
* Move tasks through stages
**By Priority:**
* Urgent for critical items
* High for important
* Medium for standard
* Low for nice-to-haves
**By Assignee:**
* Clear ownership
* Don't over-assign one person
* Use filters to see individual workloads
### Resource Organization
Organize knowledge base content:
**Page Naming:**
```
Meeting Notes - 2024-01-15
Product Requirements - Feature X
How to: Deploy to Production
[Template] Project Brief
```
**Logical Grouping:**
* Group related pages together
* Use consistent naming patterns
* Archive outdated content
## Templates and Standards
### Project Templates
Create templates for common project types:
**Starter content:**
* Welcome/overview page
* Standard task list
* Common resources
### Document Templates
Create reusable document templates:
* Meeting notes template
* Project brief template
* Decision log template
* Status update template
### Task Templates
For recurring task sets:
* Sprint checklist
* Release tasks
* Onboarding tasks
* Review process
## Managing Project Lifecycle
### Starting a Project
When creating a new project:
Clear objective for the project.
Create based on template or from scratch.
Overview page, first tasks, key resources.
Add the right people with appropriate roles.
Let the team know about the new project.
### Maintaining a Project
Keep projects healthy:
* **Regular cleanup**: Archive completed tasks
* **Update documentation**: Keep pages current
* **Review access**: Remove inactive members
* **Check relevance**: Is this project still needed?
### Closing a Project
When a project is complete:
All tasks done, objectives met.
Create summary page with results.
Move to archive state.
Announce project completion.
## Common Patterns
### Product Development Project
```
Project: Mobile App v2.0
Prefix: APP2
Resources:
├── Product Requirements
├── Technical Specifications
├── Design Guidelines
└── Meeting Notes
Tasks:
├── [Backlog] Feature ideas
├── [To Do] Sprint work
├── [In Progress] Current sprint
└── [Done] Completed work
```
### Marketing Campaign Project
```
Project: Q1 Product Launch
Prefix: LAUNCH
Resources:
├── Campaign Brief
├── Content Calendar
├── Asset Library
└── Performance Reports
Tasks:
├── Content creation
├── Social media
├── Email campaigns
└── Analytics
```
### Client Project
```
Project: Acme Corp Website
Prefix: ACME
Resources:
├── Project Scope
├── Design Concepts
├── Meeting Notes
└── Deliverables
Tasks:
├── Discovery phase
├── Design phase
├── Development phase
└── Launch phase
```
## Scaling Your Organization
### As Your Team Grows
Adjust structure as needed:
| Team Size | Recommendation |
| --------- | -------------------------------------- |
| 1-10 | Simple structure, few areas |
| 10-50 | More areas, consistent conventions |
| 50+ | Formal hierarchy, documented standards |
### Signs You Need to Reorganize
* Hard to find things
* Duplicate projects exist
* Confusion about where things belong
* New members struggle to navigate
### Reorganization Tips
Document the new structure before making changes. Get buy-in from key stakeholders.
Announce reorganization, explain the new structure, update any documentation.
Don't change everything at once. Move projects incrementally.
Archive or delete empty areas and projects after migration.
## Best Practices Summary
Start with a minimal structure. Add complexity only when needed.
Apply the same patterns across similar projects. Document your conventions.
Periodically audit your structure. Archive completed projects.
If people can't find things, the structure needs work.
As your team grows, evolve the structure—but thoughtfully, with planning.
## Next Steps
Get your team set up effectively.
Maximize productivity with AI coworkers.
# GitHub Integration
Source: https://docs.trilo.chat/integrations/github
Connect GitHub to your Trilo workspace for AI-powered code collaboration
Connect GitHub to Trilo and let your AI coworkers help with code-related tasks. They can read repositories, create issues, review PRs, and keep your team informed about code changes.
## What AI Can Do with GitHub
Once connected, AI coworkers can:
| Capability | Example Use |
| ------------------------ | ------------------------------------------------ |
| **Read repositories** | "What's the structure of our main repo?" |
| **Search code** | "Find all files that use the auth service" |
| **Create issues** | "Create an issue for the login bug we discussed" |
| **Read issues** | "What are the open issues labeled 'urgent'?" |
| **Create pull requests** | "Open a PR with these changes" |
| **Review PRs** | "Summarize the changes in PR #42" |
| **Track activity** | "What was merged this week?" |
## Prerequisites
Before connecting GitHub:
* You need a GitHub account with access to the repositories you want to connect
* You must be a Trilo workspace admin (or have integration permissions)
* Your GitHub organization must allow OAuth apps (if connecting org repos)
## Connecting GitHub
Click **Settings** in the Trilo sidebar.
Select the **Integrations** section.
In the workspace integrations list, find **GitHub** and click **Connect**.
You'll be redirected to GitHub. Sign in if needed and review the permissions.
Choose which repositories Trilo can access:
* **All repositories** - Access to all repos you have access to
* **Selected repositories** - Choose specific repos
Click **Install** to complete the connection.
For organization repositories, you may need organization owner approval before the app can be installed.
## Configuring Repository Access
After connecting, configure which projects can use GitHub:
Navigate to a project that needs GitHub access.
Click the settings icon in the project header.
Find the **Integrations** tab.
Select the GitHub integration from available workspace integrations.
Select which repositories this project should have access to.
## Permissions Explained
| Permission | Why It's Needed |
| ---------------------------- | -------------------------------------------------- |
| **Read code** | To search code and understand repository structure |
| **Read issues** | To list and search existing issues |
| **Write issues** | To create issues from conversations |
| **Read pull requests** | To summarize and review PRs |
| **Write pull requests** | To create PRs when requested |
| **Read repository metadata** | To list repos and branches |
## Using GitHub with AI Coworkers
### In Project Chat
Ask AI coworkers about your code:
```
You: What are the open bugs in our backend repo?
AI: I found 5 open issues labeled 'bug' in acme/backend...
You: Create an issue for the memory leak we discussed
AI: Created issue #234 "Memory leak in user service" with the details from our conversation.
You: Summarize the changes in this week's PRs
AI: This week had 12 merged PRs. The main changes include...
```
### In Tasks
When AI coworkers work on tasks, they can:
* Reference related GitHub issues
* Create issues for bugs discovered during work
* Link PRs to task completion
### In Workflows
Automated workflows can:
* Monitor repositories for new issues
* Get notified of PR merges
* Create tasks from GitHub issues
## Best Practices
Don't give every project access to every repository. The marketing project doesn't need access to the infrastructure repo. This keeps AI focused on relevant context.
AI coworkers are great at creating issues and summarizing code. For actual code changes, developers should push commits directly. AI can create PRs for simple changes if requested.
If you have repositories with secrets, credentials, or sensitive business logic, consider not connecting them. AI doesn't need access to everything.
## Troubleshooting
Your organization may need to approve the Trilo GitHub app. Ask an organization owner to approve it in **Organization Settings → Third-party Access**.
Check that:
1. The repository is included in your GitHub app installation
2. The repository is assigned to the project you're chatting in
3. Your personal GitHub permissions include that repository
The OAuth token may have expired. Click **Reconnect** in Trilo's integration settings to re-authorize.
Verify that the GitHub app has write permissions. If you selected read-only during setup, you'll need to update the app's permissions in GitHub.
## Disconnecting GitHub
To remove the GitHub integration:
Click **Settings** → **Integrations**.
Locate the GitHub integration in the list.
Select **Disconnect** from the menu.
Confirm that you want to remove the integration.
Disconnecting removes access for all projects. AI coworkers will no longer be able to interact with GitHub.
## Security Considerations
* **OAuth-based**: Uses GitHub OAuth, not personal access tokens
* **Granular access**: You choose which repositories to share
* **Revocable**: Can be disconnected anytime from Trilo or GitHub
* **Audit logged**: Actions are tracked in task and workspace activity
## Next Steps
See all available integrations.
Learn what AI can do with integrations.
# Gmail Integration
Source: https://docs.trilo.chat/integrations/gmail
Connect Gmail to Trilo and let AI help manage your email
Connect Gmail to Trilo and let AI coworkers help you manage email. They can read messages, search your inbox, draft replies, and send emails on your behalf. This is a personal integration—only you can use your connected Gmail.
## What AI Can Do with Gmail
Once connected, AI coworkers can:
| Capability | Example Use |
| --------------------- | --------------------------------------------- |
| **Read emails** | "What emails did I get from clients today?" |
| **Search inbox** | "Find the email about the Q4 budget" |
| **Draft emails** | "Draft a reply to Sarah's proposal" |
| **Send emails** | "Send the follow-up to the meeting attendees" |
| **Summarize threads** | "Summarize the email chain with Acme Corp" |
| **Find attachments** | "Find the PDF John sent last week" |
## Prerequisites
* A Gmail account (or Google Workspace email)
* Access to Trilo's personal integrations settings
## Connecting Gmail
Click your avatar in Trilo, then select **Settings**.
Select the **Integrations** tab.
In the **Personal** integrations section, find **Gmail**.
Click the **Connect** button.
You'll be redirected to Google. Sign in with your Gmail account.
Review and accept the permissions:
* Read your email messages
* Send email on your behalf
* Manage labels and drafts
AI can send emails on your behalf. Always review AI-drafted emails before confirming to send.
## Using Gmail with AI Coworkers
Chat with AI in your **direct messages** about email:
### Reading and Searching
```
You: What emails do I have from marketing this week?
AI: You have 5 emails from the marketing team:
1. Campaign Results - from Sarah (Monday)
2. Re: Q1 Planning - from Mike (Tuesday)
...
You: What did Sarah's email say about the campaign?
AI: Sarah's email summarized the Q4 campaign results:
- 15% increase in conversions
- Email open rate at 28%
- Recommended focusing on...
```
### Drafting Emails
```
You: Draft a reply to Sarah thanking her for the report
AI: Here's a draft reply:
Subject: Re: Campaign Results
Hi Sarah,
Thank you for the detailed campaign report...
Would you like me to send this or make any changes?
You: Make it more concise and add a question about next quarter
AI: Here's the updated draft:
...
```
### Sending Emails
```
You: Send the email
AI: Email sent to Sarah at sarah@company.com.
```
AI will always show you the email content before sending and ask for confirmation.
## Privacy and Data
### Your Email is Private
* **Personal integration**: Only you can access your Gmail through Trilo
* **No storage**: Trilo doesn't store your emails; it reads them on-demand
* **Your DMs only**: Gmail access only works in direct messages with AI coworkers
* **Not in projects**: Team members cannot use your Gmail integration
### What AI Can See
When you ask AI about email:
* AI reads relevant messages to answer your question
* AI doesn't proactively scan your entire inbox
* Emails are processed in context of your conversation
## Permissions Explained
| Permission | Why It's Needed |
| ----------------- | ------------------------------------- |
| **Read emails** | To search and summarize your messages |
| **Send emails** | To send emails when you confirm |
| **Manage drafts** | To create and update email drafts |
| **Manage labels** | To organize emails when requested |
## Best Practices
AI drafts can be helpful, but always read the email before confirming send. Check tone, accuracy, and that the right recipients are included.
AI is particularly good at finding old emails and summarizing long threads. "Find the contract John sent in September" is a great use case.
Instead of "check my email," try "what emails did I get from clients this week?" Specificity helps AI give better results.
## Troubleshooting
Check that:
1. You're in a **direct message** with AI (not a project chat)
2. The integration is still connected (Settings → Integrations)
3. Try disconnecting and reconnecting
Your Google account may have restrictions:
1. Google Workspace admins can disable third-party access
2. Contact your IT admin if using a work account
3. Try with a personal Gmail account to test
Be more specific:
* Include sender name or email
* Include keywords from the subject or body
* Specify a date range
This is a recipient issue, not a Trilo issue. The email was sent correctly from your Gmail. The recipient's spam filter caught it.
## Disconnecting Gmail
Click your avatar → **Settings** → **Integrations**.
Locate the Gmail integration.
Confirm the disconnection.
Also revoke access from [Google Account Permissions](https://myaccount.google.com/permissions).
## Security Considerations
* **OAuth-based**: Uses Google OAuth, not your password
* **Revocable**: Can be disconnected anytime from Trilo or Google
* **No password stored**: Trilo never sees your Gmail password
* **Personal only**: Your email access isn't shared with teammates
## Next Steps
Also connect your calendar.
Learn more about AI capabilities.
See other available integrations.
# Google Calendar Integration
Source: https://docs.trilo.chat/integrations/google-calendar
Sync Google Calendar with Trilo for unified scheduling
Connect Google Calendar to see all your events in Trilo and let AI coworkers help manage your schedule. This is a personal integration—only you can use your connected calendar.
## What AI Can Do with Google Calendar
Once connected, AI coworkers can:
| Capability | Example Use |
| ---------------------- | ----------------------------------------- |
| **Check availability** | "Am I free tomorrow at 2pm?" |
| **View schedule** | "What meetings do I have this week?" |
| **Create events** | "Schedule a team sync for Friday at 10am" |
| **Find open slots** | "When can I meet with Sarah?" |
| **Send invites** | "Invite the team to a planning meeting" |
| **Manage events** | "Reschedule my 3pm to 4pm" |
## Prerequisites
* A Google account with Google Calendar
* Access to Trilo's personal integrations settings
## Connecting Google Calendar
Click your avatar in Trilo, then select **Settings**.
Select the **Integrations** tab.
In the **Personal** integrations section, find **Google Calendar**.
Click the **Connect** button.
You'll be redirected to Google. Sign in with your Google account.
Review and accept the permissions Trilo needs:
* View your calendars
* View events on your calendars
* Create and modify events
Choose which calendars to sync (work, personal, shared, etc.).
## Configuring Calendar Sync
After connecting, configure how your calendar syncs:
### Choosing Calendars
In Trilo's calendar view, click the settings icon.
Toggle which Google calendars to show in Trilo.
Choose which calendar new events should be created in.
### Sync Direction
| Direction | What Happens |
| ------------------ | -------------------------------------------------- |
| **Google → Trilo** | Events from Google appear in Trilo's calendar view |
| **Trilo → Google** | Events created in Trilo sync back to Google |
| **Two-way** | Changes in either system sync to the other |
## Using with AI Coworkers
Chat with AI coworkers about your schedule in DMs:
```
You: What's my schedule tomorrow?
AI: Tomorrow you have:
- 9:00 AM: Team standup
- 11:00 AM: Client call with Acme Corp
- 2:00 PM: One-on-one with Sarah
Your afternoon after 3 PM is free.
You: Am I free for a 30-minute call on Thursday?
AI: Yes, you have these open slots on Thursday:
- 10:00 AM - 11:00 AM
- 1:00 PM - 2:30 PM
- 4:00 PM - 5:00 PM
You: Schedule a planning meeting for Thursday at 1pm
AI: Created "Planning Meeting" for Thursday at 1:00 PM.
Would you like me to add any attendees?
```
## Calendar Views in Trilo
### Unified View
With Google Calendar connected:
* All events show in Trilo's calendar
* Events are color-coded by calendar source
* Click any event to see details or edit
### Creating Events
Events created in Trilo can:
* Sync to your Google Calendar
* Include Trilo video call links
* Be attached to projects for context
## Permissions Explained
| Permission | Why It's Needed |
| ---------------------- | -------------------------------------------- |
| **See your calendars** | To list which calendars you have |
| **View events** | To show your schedule and check availability |
| **Create events** | To schedule meetings when you ask AI |
| **Modify events** | To reschedule or update existing events |
## Privacy and Data
This is a **personal** integration. Your calendar data is only visible to you and AI coworkers in your direct messages. Team members cannot see your synced calendar events unless you explicitly share them.
## Troubleshooting
Try these steps:
1. Check that the calendar is enabled in Trilo's calendar settings
2. Click refresh to force a sync
3. Verify your internet connection
4. Disconnect and reconnect the integration
Time zone mismatch. Check:
1. Your Trilo timezone (Settings → Profile)
2. Your Google Calendar timezone
3. Make sure they match or Trilo will convert correctly
Try:
1. Clear your browser cookies for accounts.google.com
2. Try a different browser
3. Ensure pop-ups are allowed
4. Check if your Google account has calendar access enabled
The integration only works in **direct messages** with AI coworkers, not in project chats. Start a DM with an AI coworker and try again.
## Disconnecting Google Calendar
Click your avatar → **Settings** → **Integrations**.
Locate the integration in your personal integrations.
Select **Disconnect** and confirm.
You can also revoke access from [Google Account Security](https://myaccount.google.com/security-checkup).
## Best Practices
Don't sync every calendar you have. Sync your primary work calendar and maybe one personal calendar. Too many calendars create noise.
Make sure your default calendar is set correctly so AI-created events go to the right place.
For meetings with external people, use Trilo's built-in booking pages instead of asking AI to schedule. It's more efficient.
## Next Steps
Learn about Trilo's calendar features.
Set up scheduling for external meetings.
See other available integrations.
# Shopify Integration
Source: https://docs.trilo.chat/integrations/shopify
Connect Shopify to your Trilo workspace for AI-powered store management
Connect Shopify to Trilo and let AI coworkers help with your e-commerce operations. They can check orders, manage inventory, track products, and help your team stay on top of store activity.
## What AI Can Do with Shopify
Once connected, AI coworkers can:
| Capability | Example Use |
| ------------------- | -------------------------------------------------------------- |
| **Check orders** | "How many orders came in today?" |
| **Order details** | "What's the status of order #1234?" |
| **Track inventory** | "Which products are low in stock?" |
| **Product info** | "What's the price of the blue t-shirt?" |
| **Customer lookup** | "Find orders from [john@example.com](mailto:john@example.com)" |
| **Sales reports** | "What were our top sellers this week?" |
## Prerequisites
* Shopify store with admin access
* Trilo workspace admin (or integration permissions)
## Connecting Shopify
Click **Settings** in the Trilo sidebar.
Select the **Integrations** section.
In workspace integrations, find **Shopify** and click **Connect**.
Enter your Shopify store URL (e.g., yourstore.myshopify.com).
You'll be redirected to Shopify. Click **Install app**.
Review the permissions and click **Install**.
## Configuring Store Access
### Project-Level Setup
Navigate to the project that needs Shopify access (e.g., "E-commerce Ops").
Click the settings icon.
In the Integrations tab, add the Shopify integration.
If you have multiple stores, choose which one this project accesses.
### Multiple Stores
If you have multiple Shopify stores:
* Connect each store separately in workspace settings
* Assign different stores to different projects
* AI knows which store to query based on project context
## Using Shopify with AI Coworkers
### In Project Chat
Ask AI about your store in any project with Shopify access:
```
You: How many orders did we get today?
AI: You received 47 orders today totaling $3,842.
- 32 orders shipped
- 12 orders processing
- 3 orders pending payment
You: Any orders over $200?
AI: Yes, 5 orders over $200:
1. Order #4521 - $342 - Sarah M. (shipped)
2. Order #4519 - $287 - John D. (processing)
...
You: What's the status of order #4519?
AI: Order #4519:
- Customer: John D.
- Total: $287
- Status: Processing
- Items: 2x Blue T-Shirt, 1x Black Hoodie
- Payment: Completed via Shopify Payments
```
### Inventory Management
```
You: Which products are running low?
AI: 3 products are below restock threshold:
- Blue T-Shirt (S): 2 remaining
- Black Hoodie (M): 4 remaining
- White Cap: 1 remaining
You: Create a task to reorder Blue T-Shirts
AI: Created task "Reorder Blue T-Shirt (S) - Low Inventory"
assigned to the current project.
```
### Sales Insights
```
You: What were our top products this week?
AI: Top 5 products by revenue this week:
1. Black Hoodie - $2,450 (35 units)
2. Blue T-Shirt - $1,890 (63 units)
3. Premium Bundle - $1,200 (8 units)
...
```
## Permissions Explained
| Permission | Why It's Needed |
| ------------------ | --------------------------------- |
| **Read orders** | To check order status and history |
| **Read products** | To look up product information |
| **Read inventory** | To track stock levels |
| **Read customers** | To look up customer orders |
Trilo requests **read-only** permissions by default. AI can view store data but won't modify orders or inventory directly.
## Best Practices
Set up a project specifically for store operations. Add your support and fulfillment team. This keeps store queries organized.
AI is great for "what's the status of..." and "how many..." questions. For complex operations, use Shopify admin directly.
When AI finds issues (low inventory, pending orders), ask it to create tasks. This keeps your team accountable.
## Troubleshooting
Check that:
1. The Shopify integration is connected at the workspace level
2. The integration is assigned to your current project
3. You're asking about the correct store (if you have multiple)
The API credentials may have changed. Click **Reconnect** in Trilo and re-authorize in Shopify.
AI queries Shopify in real-time, but there might be brief delays. Try asking again or check Shopify admin directly for time-sensitive data.
Ensure:
1. You're a Shopify store admin
2. Your store allows third-party apps
3. You're using the correct store URL format
## Disconnecting Shopify
Click **Settings** → **Integrations**.
Locate the Shopify integration.
Confirm the disconnection.
Also uninstall from Shopify: **Shopify Admin → Settings → Apps → Trilo → Uninstall**.
## Security Considerations
* **OAuth-based**: Uses Shopify OAuth, not API keys
* **Read-only default**: AI views data but doesn't modify it
* **Store-level access**: You control which stores are connected
* **Project-level control**: Only projects you configure can access store data
## Next Steps
Learn more about AI capabilities.
Automate store monitoring with AI workflows.
See other available integrations.
# Slack Integration
Source: https://docs.trilo.chat/integrations/slack
Connect Slack to your Trilo workspace for cross-platform communication
Connect Slack to Trilo to bridge communication between platforms. AI coworkers can post updates to Slack channels, send notifications, and help teams that use both tools stay in sync.
This guide is for using Slack **alongside** Trilo. If you're replacing Slack entirely, see the [migration guide](/migrations/from-slack).
## What AI Can Do with Slack
Once connected, AI coworkers can:
| Capability | Example Use |
| ---------------------- | --------------------------------------- |
| **Post messages** | "Post a project update to #engineering" |
| **Send notifications** | Automated alerts for task completions |
| **Read channels** | "What's being discussed in #marketing?" |
| **Cross-post updates** | Share Trilo activity in Slack |
## When to Use This Integration
### Good Use Cases
* **Notification bridge**: Get Trilo alerts in Slack
* **Status updates**: Post project updates to Slack automatically
* **Gradual migration**: Use both tools during transition period
* **External stakeholders**: Stakeholders in Slack, team in Trilo
### Consider Alternatives
If your whole team uses Slack, consider:
* **Full migration**: Move to Trilo completely ([migration guide](/migrations/from-slack))
* **All-in-Trilo**: Use Trilo's built-in chat instead
Running two chat platforms long-term creates confusion.
## Prerequisites
* Slack workspace admin access (or permission to add apps)
* Trilo workspace admin (or integration permissions)
## Connecting Slack
Click **Settings** in the Trilo sidebar.
Select the **Integrations** section.
In workspace integrations, find **Slack** and click **Connect**.
You'll be redirected to Slack. Sign in if needed.
Choose which Slack workspace to connect.
Review permissions and click **Allow**.
Choose which Slack channels Trilo can access.
## Configuring Slack Access
### Project-Level Configuration
Navigate to the project that needs Slack access.
Click the settings icon.
In the Integrations tab, add the Slack integration.
Select which Slack channels this project can post to.
### Channel Mapping Example
| Trilo Project | Slack Channel |
| ------------------- | --------------- |
| Engineering | #engineering |
| Marketing Campaigns | #marketing |
| Product Launch | #product-launch |
## Using Slack with AI Coworkers
### In Project Chat
```
You: Post an update to Slack about the feature release
AI: I'll post this to #engineering:
"🚀 Feature Release: User Dashboard v2.0 is live!
Key updates: New widgets, faster load times, dark mode.
See full notes: [link]"
Should I post this?
You: Yes, post it
AI: Posted to #engineering successfully.
```
### Automated Notifications
Set up workflows to automatically post:
* Task completions to relevant Slack channels
* Meeting summaries after video calls
* Weekly project updates
## Permissions Explained
| Permission | Why It's Needed |
| ------------------------- | ----------------------------------- |
| **Post messages** | To send updates to Slack channels |
| **Read channels** | To see context and avoid duplicates |
| **Access workspace info** | To list available channels |
## Best Practices
Pick one platform for real-time discussion. Use Slack for quick updates/notifications, but don't have the same conversation in both places.
The best use of this integration is Trilo → Slack updates, not two-way conversation. Project updates, completion notifications, status reports.
If you're using both Slack and Trilo long-term, define clear boundaries. Otherwise, plan to consolidate into one platform.
## Troubleshooting
Check that:
1. The Slack channel is included in the integration setup
2. The channel is assigned to the project you're working in
3. The Trilo app is added to the Slack channel
The OAuth token may have expired. Click **Reconnect** in Trilo's integration settings.
Verify:
1. The Trilo app isn't muted in Slack
2. The channel allows app posts
3. Check Slack's app settings for Trilo
## Disconnecting Slack
Click **Settings** → **Integrations**.
Locate the Slack integration.
Confirm the disconnection.
Also remove the app from Slack: **Slack Settings → Manage Apps → Trilo → Remove**.
## Next Steps
Replace Slack entirely with Trilo.
Use Trilo's built-in team chat.
See other available integrations.
# Boards
Source: https://docs.trilo.chat/knowledge-base/boards
Visual whiteboards for brainstorming, diagramming, and creative collaboration
Boards are infinite canvas whiteboards where your team can brainstorm, diagram, sketch, and visualize ideas together. They're built on Excalidraw, providing a hand-drawn aesthetic that's perfect for creative work.
## Creating a Board
Open a project and click on **Resources** in the navigation.
Click the **+ New** button.
Choose **Board** from the dropdown menu.
Give it a descriptive name.
## The Canvas
### Navigation
Move around the infinite canvas:
* **Pan**: Click and drag on empty space, or hold `Space` and drag
* **Zoom in**: `Cmd/Ctrl + +` or scroll up
* **Zoom out**: `Cmd/Ctrl + -` or scroll down
* **Fit to screen**: `Cmd/Ctrl + 1`
* **Reset zoom**: `Cmd/Ctrl + 0`
### Canvas Settings
Access canvas settings from the menu:
* **Grid**: Toggle grid visibility for alignment
* **Background**: Change the canvas background color
* **Snap to grid**: Enable for precise positioning
## Drawing Tools
The toolbar provides everything you need to create:
### Selection Tool (V)
* **Click** to select objects
* **Drag** to create a selection box
* **Shift + click** to add to selection
* **Drag** selected objects to move them
### Shapes
| Tool | Shortcut | Description |
| ------------- | -------- | --------------------------- |
| **Rectangle** | `R` | Draw rectangles and squares |
| **Ellipse** | `O` | Draw circles and ovals |
| **Diamond** | `D` | Draw diamond shapes |
| **Line** | `L` | Draw straight lines |
| **Arrow** | `A` | Draw arrows |
| **Freehand** | `P` | Draw freeform lines |
### Text (T)
Add text to your board:
1. Select the text tool or press `T`
2. Click where you want to add text
3. Type your content
4. Click outside to finish
Text options:
* Font size (Small, Medium, Large, Extra Large)
* Font family
* Text alignment
* Text color
### Sticky Notes
Perfect for brainstorming:
1. Select the sticky note tool
2. Click to place a note
3. Type your content
4. Choose a color for visual organization
## Styling Objects
Select any object to customize its appearance:
### Stroke
* **Color**: Choose from the color palette
* **Width**: Thin, normal, or thick
* **Style**: Solid, dashed, or dotted
### Fill
* **Color**: Choose a fill color
* **Style**: Solid, hatch, cross-hatch, or transparent
### Opacity
Adjust transparency from fully opaque to transparent.
### Edges
For shapes:
* **Sharp**: Pointed corners
* **Round**: Rounded corners
### Arrowheads
For lines and arrows:
* None, arrow, bar, dot, or triangle
* Set independently for start and end
## Working with Objects
### Selecting Multiple Objects
* **Drag selection**: Draw a box around objects
* **Shift + click**: Add objects to selection
* **Cmd/Ctrl + A**: Select all objects
### Transforming Objects
* **Move**: Drag selected objects
* **Resize**: Drag corner or edge handles
* **Rotate**: Drag the rotation handle (circle above object)
* **Maintain proportions**: Hold `Shift` while resizing
### Arranging Objects
Right-click or use the menu to:
* **Bring to front**: `Cmd/Ctrl + Shift + ]`
* **Send to back**: `Cmd/Ctrl + Shift + [`
* **Bring forward**: `Cmd/Ctrl + ]`
* **Send backward**: `Cmd/Ctrl + [`
### Aligning Objects
Select multiple objects and use alignment options:
* Align left, center, or right
* Align top, middle, or bottom
* Distribute horizontally or vertically
### Grouping
Combine objects to move and transform them together:
* **Group**: Select objects and press `Cmd/Ctrl + G`
* **Ungroup**: Select group and press `Cmd/Ctrl + Shift + G`
## Collaboration
### Real-Time Collaboration
Work together on boards:
* See teammates' cursors in real-time
* Watch as objects are created and modified
* Colored cursors show who's doing what
### Presence
The board shows:
* Avatars of everyone viewing the board
* Each person's cursor position
* Currently selected objects
## Images
Add images to your board:
Drag and drop an image file onto the canvas, or use the image tool.
Drag to move, use handles to resize.
Adjust opacity or add a border if needed.
Supported formats: PNG, JPG, GIF, SVG
## Libraries
Save and reuse common elements:
### Using Libraries
1. Click the library icon in the toolbar
2. Browse available shapes and components
3. Click to add to your canvas
### Creating Library Items
1. Select the objects you want to save
2. Click **Add to library**
3. Name your library item
4. Use it across all your boards
## Exporting
Export your board in various formats:
### Export Options
Click the export button to:
* **PNG**: Image file with transparent background option
* **SVG**: Vector format for scalability
* **Copy to clipboard**: Paste into other apps
### Export Settings
* **Background**: Include or exclude
* **Scale**: 1x, 2x, or 3x resolution
* **Selection only**: Export just selected objects
## Keyboard Shortcuts
| Action | Shortcut |
| --------- | ----------------------- |
| Selection | `V` |
| Rectangle | `R` |
| Ellipse | `O` |
| Diamond | `D` |
| Line | `L` |
| Arrow | `A` |
| Freehand | `P` |
| Text | `T` |
| Delete | `Delete` or `Backspace` |
| Duplicate | `Cmd/Ctrl + D` |
| Copy | `Cmd/Ctrl + C` |
| Paste | `Cmd/Ctrl + V` |
| Undo | `Cmd/Ctrl + Z` |
| Redo | `Cmd/Ctrl + Shift + Z` |
| Group | `Cmd/Ctrl + G` |
| Ungroup | `Cmd/Ctrl + Shift + G` |
| Pan | `Space` + drag |
| Zoom in | `Cmd/Ctrl + +` |
| Zoom out | `Cmd/Ctrl + -` |
## Use Cases
Use sticky notes and freeform drawing to capture ideas quickly during team sessions.
Create process flows with shapes and arrows to document workflows.
Sketch out UI concepts and layouts before development.
Organize thoughts and explore connections between ideas.
## Best Practices
Assign colors to categories or priorities to make your board easier to scan and understand.
Group objects that belong together so they can be moved and scaled as a unit.
Create rectangles as frames to organize different sections of your board.
Use text labels to add context and make your diagrams self-explanatory.
## Next Steps
Learn how to organize all your resources effectively.
Share your boards with team members or externally.
# Organizing Resources
Source: https://docs.trilo.chat/knowledge-base/organizing-resources
Best practices for organizing your knowledge base for maximum efficiency
A well-organized knowledge base helps your team find information quickly and keeps everyone aligned. This guide covers strategies and features for keeping your resources organized.
## Organization Hierarchy
Trilo uses a three-level hierarchy to organize content:
```
Workspace
├── Area (e.g., "Engineering")
│ ├── Project (e.g., "API Development")
│ │ ├── Resources (Pages, Spreadsheets, Boards)
│ │ ├── Tasks
│ │ └── Chat
│ └── Project (e.g., "Frontend")
│ └── ...
└── Area (e.g., "Marketing")
└── Project (e.g., "Q1 Campaign")
└── ...
```
### Areas
Areas are high-level categories for grouping related projects:
**Common area structures:**
* **By department**: Engineering, Marketing, Sales, Operations
* **By client**: Client A, Client B, Internal
* **By initiative**: Product Launch, Growth, Infrastructure
* **By time**: Q1 2024, Q2 2024, Ongoing
### Projects
Projects contain the actual work and resources:
* Each project has its own Resources section
* Projects have dedicated chat channels
* Tasks are organized within projects
* Projects can have their own member permissions
## Organizing Within Projects
### Resource List
The Resources section shows all resources in a project:
* **List view**: See all resources with key details
* **Sort options**: By name, date created, date modified
* **Filter**: Show only pages, spreadsheets, or boards
### Naming Conventions
Consistent naming helps everyone find what they need:
Establish naming conventions early and document them for your team.
**Good naming patterns:**
| Type | Pattern | Example |
| ------------- | -------------------------- | -------------------------------------- |
| Meeting notes | `[Date] Meeting - [Topic]` | `2024-01-15 Meeting - Sprint Planning` |
| Documentation | `[System] - [Topic]` | `API - Authentication Guide` |
| Templates | `[Template] [Type]` | `[Template] Project Brief` |
| Versions | `[Name] v[Number]` | `Product Spec v2` |
### Using Prefixes
Prefixes help categorize resources at a glance:
* `[Draft]` - Work in progress
* `[Archive]` - Historical reference
* `[Template]` - Reusable starting point
* `[WIP]` - Active work, not final
## Active Work vs. Archive
### Managing Active Resources
Keep your resource list focused on current work:
* Pin frequently-used resources to keep them at the top
* Review resources regularly and archive what's no longer active
* Use clear status indicators in names if helpful
### Archiving Resources
Archive resources that are no longer actively used but need to be preserved:
Click on the resource you want to archive.
Click the **...** menu in the top right.
Select **Archive**. The resource will be moved to the archive.
### Accessing Archived Resources
To view archived resources:
1. Go to the Resources section
2. Click **View archive** or filter by archived status
3. Archived resources appear grayed out
4. Click **Restore** to bring a resource back to active status
## Cross-Project Resources
Sometimes resources are relevant to multiple projects.
### Linking to Resources
Reference resources from other projects:
1. Copy the resource link from the **...** menu
2. Paste the link in pages or chat messages
3. Links are clickable and show preview cards
### Moving Resources
Move a resource to a different project:
1. Open the resource
2. Click **...** menu
3. Select **Move to...**
4. Choose the destination project
5. Confirm the move
Moving a resource may change who has access to it based on project permissions.
## Templates
Create reusable templates for common resource types.
### Creating a Template
Create a page, spreadsheet, or board with the structure you want to reuse.
Add placeholder text, structure, and formatting.
Use a prefix like `[Template]` in the name.
Keep all templates in a dedicated project for easy access.
### Using a Template
1. Open the template resource
2. Click **...** menu and select **Duplicate**
3. Rename the duplicate for your specific use
4. Move it to the appropriate project if needed
5. Fill in the content
### Template Ideas
* Date and attendees
* Agenda items
* Discussion notes
* Action items
* Next steps
* Overview
* Goals and objectives
* Scope
* Timeline
* Stakeholders
* Decision date
* Context
* Options considered
* Decision made
* Rationale
* What went well
* What could improve
* Action items
* Team feedback
## Search and Discovery
### Global Search
Use search to find resources across your workspace:
* Press `Cmd/Ctrl + K` to open search
* Type keywords from the resource title or content
* Results show recent items first
* Click a result to open the resource
### Search Tips
* Search finds matches in titles and content
* Use specific keywords for better results
* Recent items appear higher in results
* Filter by resource type if needed
## Organization Best Practices
Avoid creating too many nested levels. A flatter structure is easier to navigate and understand.
Schedule regular cleanup sessions to archive completed or outdated resources. This keeps your active view focused.
Create a "How We Organize" page that explains your team's conventions. This helps new team members get up to speed quickly.
Your organization needs will evolve. Periodically review your structure and make adjustments as your team grows or changes.
Agree on naming conventions as a team and stick to them. Consistency makes everything easier to find.
## Example Structures
### Small Team (5-10 people)
```
Workspace
├── Products
│ ├── Mobile App
│ └── Web Platform
├── Marketing
│ └── Content
└── Operations
└── Team Docs
```
### Growing Company (20-50 people)
```
Workspace
├── Engineering
│ ├── Backend Services
│ ├── Frontend
│ └── Infrastructure
├── Product
│ ├── Roadmap
│ └── Research
├── Marketing
│ ├── Brand
│ ├── Content
│ └── Campaigns
├── Sales
│ ├── Prospects
│ └── Customer Success
└── Operations
├── HR
├── Finance
└── Company Docs
```
## Next Steps
Learn how to share resources internally and externally.
Deep dive into workspace organization.
# Knowledge Base Overview
Source: https://docs.trilo.chat/knowledge-base/overview
Create, organize, and share your team's knowledge in one central location
The Knowledge Base is where your team's knowledge lives. Create rich documents, interactive spreadsheets, and visual whiteboards—all organized and easily searchable.
## What's in the Knowledge Base?
Trilo's knowledge base supports three types of resources:
Rich text documents with formatting, images, embeds, and real-time collaboration.
Tables and data with formulas, filtering, and import/export capabilities.
Visual whiteboards for brainstorming, diagramming, and creative work.
## Key Features
### Real-Time Collaboration
Multiple team members can work on the same resource simultaneously:
* See who's viewing and editing in real-time
* Changes sync instantly across all viewers
* No more emailing documents back and forth
### Powerful Organization
Keep your knowledge organized with:
* **Project-based structure**: Resources belong to projects, making them easy to find
* **Drag-and-drop**: Reorganize resources with simple drag and drop
* **Archive system**: Archive inactive resources without deleting them
### AI-Powered Assistance
AI helps you work smarter:
* Get AI-generated summaries of long documents
* Ask questions about your content
* Generate new content with AI assistance
### Easy Sharing
Share knowledge inside and outside your team:
* **Internal sharing**: All team members can access resources in their projects
* **Public links**: Create shareable links for external stakeholders
* **Custom URLs**: Set custom slugs for cleaner public URLs
## Navigating the Knowledge Base
### Finding Resources
There are several ways to find what you need:
1. **Project Resources**: Each project has a dedicated Resources section
2. **Search**: Use the global search (press `Cmd/Ctrl + K`) to find any resource
3. **Recent**: Access recently viewed resources from the sidebar
### Resource Views
When viewing resources in a project, you can:
* **List view**: See all resources in a simple list
* **Sort**: Order by name, date created, or date modified
* **Filter**: Show only specific resource types
## Getting Started
Open a project from your sidebar where you want to create resources.
Click on **Resources** in the project navigation.
Click **+ New** and choose the type of resource you want to create.
Add content to your new page, spreadsheet, or board.
## Resource Types at a Glance
| Type | Best For | Key Features |
| ---------------- | ---------------------------------------- | -------------------------------------- |
| **Pages** | Documents, notes, guides, wikis | Rich formatting, embeds, templates |
| **Spreadsheets** | Data, lists, tracking, tables | Formulas, filtering, CSV import |
| **Boards** | Diagrams, brainstorming, visual planning | Freeform drawing, shapes, sticky notes |
## Next Steps
Learn about the rich text editor and document features.
Discover spreadsheet capabilities and data import.
Explore visual whiteboarding and diagramming.
Learn best practices for organizing your knowledge base.
# Page History
Source: https://docs.trilo.chat/knowledge-base/page-history
Track changes to pages and restore previous versions when needed
Every change to a page is tracked. You can see who edited what, when they did it, and roll back to any previous version if something goes wrong.
## Viewing page history
1. Open any page in the editor
2. Click the **clock icon** in the toolbar (or use the **...** menu)
3. A sidebar opens showing the page's history
The timeline shows changes in reverse chronological order—newest at the top.
## What's in the timeline
Each entry in the history shows:
* **Who made the change**: Profile picture and name (human or AI coworker)
* **When**: Relative time (e.g., "2 hours ago") or exact timestamp
* **What changed**: Brief summary of modifications
* **Snapshot type**: Manual save, automatic save, or AI edit
### Automatic vs. manual saves
**Automatic saves** happen as you edit—Trilo captures snapshots periodically so you never lose work.
**Manual saves** happen when you explicitly save a version (like "Save this before I make big changes").
### AI edits
When an AI coworker edits a page, the history clearly shows:
* Which AI made the change
* What tool or action triggered it
* The scope of changes
You'll never wonder "did I write this or did the AI?"
## Previewing old versions
Before rolling back, you probably want to see what an old version looked like:
1. Click any entry in the timeline
2. The page shows that version's content
3. A banner appears at the top: "Viewing snapshot from \[date]"
4. The editor becomes read-only while previewing
To exit preview mode, click **Cancel** in the banner or select "Current" in the timeline.
## Rolling back
If you need to restore an old version:
Scroll through the timeline and click to preview different versions.
When previewing, click the **Rollback** button in the banner.
A dialog asks you to confirm. Optionally add a note about why you're rolling back.
The page is restored to that version. A new entry appears in history showing the rollback.
Rolling back doesn't delete any history. You can always see what the page looked like before and after the rollback.
## What rollback affects
When you roll back a page:
* **Content** is restored to the selected version
* **Formatting** returns to how it was
* **History** stays intact—nothing is deleted
* **Collaboration** syncs the restored version to everyone
### Tabs and rollback
If your page has multiple tabs, rolling back restores all tabs to their state at that snapshot. You can't roll back individual tabs separately.
## Who can roll back?
Anyone who can edit a page can roll back to previous versions. There's no special permission required—but rollbacks are logged, so there's always a record of who did it.
## Collaboration and history
When multiple people edit a page:
* Each person's changes create separate history entries
* You can see who made which changes
* Rollback affects everyone's view—the page returns to the old version for all collaborators
### Conflict-free editing
Trilo uses real-time sync that handles concurrent edits smoothly. If two people edit different parts of a page simultaneously, both changes are preserved. History captures the merged result.
## Finding specific changes
For pages with lots of history:
* **Scroll** through the timeline to browse
* **Look at timestamps** to find changes from a specific time
* **Check author avatars** to find edits by a specific person
* **Read summaries** to identify particular types of changes
## History retention
Trilo keeps page history indefinitely. Older snapshots are automatically cleaned up when they're very old and redundant, but you'll always have access to meaningful change points.
## Tips
About to restructure a document? Save manually first so you have a clean restore point.
Always preview an old version before rolling back. Make sure it's actually the version you want.
When rolling back, use the optional note field to explain why. Future you will appreciate the context.
Accidentally deleted a bunch of content? Don't worry. Just find the last good version in history and roll back. Nothing is ever truly lost.
## Troubleshooting
History captures changes periodically, not every keystroke. Very recent changes might be in the current version even if they don't show as a separate snapshot yet.
You might be viewing the current version (nothing to roll back to) or you might not have edit permissions on the page.
Rollback replaces the entire page content. If someone was editing at the same time, their changes since the rolled-back version would be overwritten. They can roll back again if needed.
## Next steps
Organize content in multiple tabs.
Learn about editing together.
# Page Tabs
Source: https://docs.trilo.chat/knowledge-base/page-tabs
Organize related content in multiple tabs within a single page
Page tabs let you group related content together without creating separate pages. Think of them like tabs in a spreadsheet—one page, multiple sections, each with its own content.
## When to use tabs
Tabs work well when you have content that's related but distinct:
* **Meeting notes**: One tab per meeting, all in one "Weekly Standup" page
* **Project phases**: Planning, Development, Launch tabs in a project overview
* **Documentation sections**: Overview, API Reference, Examples tabs in a technical doc
* **Research**: Different sources or angles on the same topic
If the content isn't related, create separate pages instead.
## Creating tabs
Every page starts with one tab. To add more:
1. Look at the bottom of the page editor—you'll see a tab bar
2. Click the **+** button to add a new tab
3. Give it a name by clicking on "Untitled"
4. Start writing in the new tab
## Managing tabs
### Renaming tabs
Double-click a tab name to edit it. Press Enter or click away to save.
### Reordering tabs
Drag tabs left or right to change their order. The first tab is what people see when they open the page.
### Deleting tabs
Right-click a tab and select **Delete**. The tab and all its content will be removed.
Deleting a tab can't be undone through the interface. If you need the content back, use page history to restore a previous version.
## Collaboration in tabs
Each tab has its own editing space. Multiple people can work on different tabs simultaneously without getting in each other's way.
* Cursors and presence indicators show who's in which tab
* Changes sync in real time, just like regular pages
* AI coworkers can edit specific tabs when you ask them to
### AI editing tabs
When you ask an AI coworker to edit content, it knows which tab you're referring to. You can also be explicit:
```
You: Update the API Reference tab with the new endpoint
AI: I'll add the new endpoint to the API Reference tab...
```
## Tabs in workflows
Workflows can create and edit tabbed pages. When a workflow generates a report, it might:
* Create a new page with summary and details tabs
* Add a new tab to an existing page with fresh data
* Update a specific tab while leaving others unchanged
## Navigation
### Keyboard shortcuts
| Action | Shortcut |
| ------------- | --------------------------------- |
| Next tab | **Ctrl + Tab** |
| Previous tab | **Ctrl + Shift + Tab** |
| Go to tab 1-9 | **Ctrl + 1** through **Ctrl + 9** |
### Tab overview
If you have many tabs, hover over the tab bar to see a dropdown of all tabs. Click any tab name to jump directly to it.
## Best practices
Tab names appear in a horizontal bar, so longer names get truncated. Use brief, clear labels.
The first tab is what people see when they open the page. Make it an overview or the most commonly needed content.
If you have more than 6-8 tabs, consider whether some content should be separate pages instead. Too many tabs become hard to navigate.
Tabs are great for keeping different versions of content—Draft, Review, Final—all in one place.
## Which page types support tabs?
* **Regular pages**: Full tab support
* **Workflow pages**: No tabs (single content area)
* **Social post pages**: No tabs (single content area)
## Next steps
Track changes and restore previous versions.
Learn more about creating and editing pages.
# Pages
Source: https://docs.trilo.chat/knowledge-base/pages
Create rich documents with powerful formatting and collaboration features
Pages are the foundation of your knowledge base. Use them for documentation, meeting notes, project wikis, guides, and any text-based content your team needs.
## Creating a Page
Open a project and click on **Resources** in the navigation.
Click the **+ New** button in the top right.
Choose **Page** from the dropdown menu.
Enter a descriptive title for your page.
## The Editor
Trilo uses a powerful block-based editor that makes creating beautiful documents easy.
### Basic Formatting
Select text to access the formatting toolbar:
* **Bold**: `Cmd/Ctrl + B`
* **Italic**: `Cmd/Ctrl + I`
* **Underline**: `Cmd/Ctrl + U`
* **Strikethrough**: `Cmd/Ctrl + Shift + S`
* **Code**: `Cmd/Ctrl + E`
* **Link**: `Cmd/Ctrl + K`
### Slash Commands
Type `/` anywhere in your document to access the block menu. This lets you quickly insert:
| Command | What it creates |
| ----------- | ------------------ |
| `/h1` | Heading 1 |
| `/h2` | Heading 2 |
| `/h3` | Heading 3 |
| `/bullet` | Bullet list |
| `/numbered` | Numbered list |
| `/todo` | Checkbox list |
| `/quote` | Block quote |
| `/code` | Code block |
| `/divider` | Horizontal divider |
| `/image` | Image upload |
| `/table` | Table |
### Block Types
#### Headings
Use headings to structure your document:
* **Heading 1**: Main sections
* **Heading 2**: Subsections
* **Heading 3**: Sub-subsections
Well-structured headings make documents easier to scan and create a better table of contents.
#### Lists
Create organized content with lists:
* **Bullet lists**: For unordered items
* **Numbered lists**: For sequential steps or ranked items
* **Checklists**: For task lists and action items (check/uncheck with a click)
#### Code Blocks
Add syntax-highlighted code blocks:
1. Type `/code` or triple backticks (\`\`\`)
2. Select the programming language
3. Paste or type your code
Supported languages include JavaScript, Python, TypeScript, HTML, CSS, SQL, and many more.
#### Tables
Create tables for structured data:
1. Type `/table` to insert a table
2. Click cells to edit content
3. Use the column/row handles to add or remove rows and columns
4. Drag to reorder rows and columns
#### Images
Add images to your pages:
1. Type `/image` or drag and drop an image file
2. Click to upload from your computer
3. Resize images by dragging the corners
4. Add captions below images
### Embeds
Embed content from other services:
* **Videos**: YouTube, Vimeo, Loom
* **Design files**: Figma, Miro
* **Code**: GitHub Gists, CodePen
* **Other**: Google Docs, Notion pages, and more
Type `/embed` and paste the URL of the content you want to embed.
## Real-Time Collaboration
### Co-Editing
Multiple people can edit the same page simultaneously:
* See other editors' cursors in real-time
* Watch changes appear as they're made
* Avatars show who's currently viewing the page
### Presence Indicators
Look at the top of the page to see:
* Avatars of everyone currently viewing
* Color-coded cursors for each editor
* "X people viewing" indicator
## Page Settings
Click the **...** menu in the top right to access page settings:
### Rename
Change the page title at any time.
### Duplicate
Create a copy of the page with all its content.
### Archive
Move the page to the archive. Archived pages can be restored later.
### Delete
Permanently delete the page. This action cannot be undone.
## AI Features
### AI Writing Assistance
Get help writing content:
1. Select the text you want to improve
2. Click the AI icon or press `Cmd/Ctrl + J`
3. Choose an action:
* **Improve writing**: Polish grammar and clarity
* **Make shorter**: Condense the text
* **Make longer**: Expand on the ideas
* **Fix spelling**: Correct errors
* **Change tone**: Adjust to professional, casual, or other tones
### AI Summary
For long documents, get an AI-generated summary:
1. Click the **Summary** button at the top of the page
2. Read the condensed overview of the document's key points
## Keyboard Shortcuts
| Action | Shortcut |
| ----------------- | ---------------------- |
| Bold | `Cmd/Ctrl + B` |
| Italic | `Cmd/Ctrl + I` |
| Underline | `Cmd/Ctrl + U` |
| Strike | `Cmd/Ctrl + Shift + S` |
| Inline code | `Cmd/Ctrl + E` |
| Link | `Cmd/Ctrl + K` |
| Undo | `Cmd/Ctrl + Z` |
| Redo | `Cmd/Ctrl + Shift + Z` |
| Insert slash menu | `/` |
## Best Practices
Good titles help team members find pages quickly. Include the topic and type of content (e.g., "Q1 Marketing Strategy" or "API Integration Guide").
Break long documents into sections with headings. This improves readability and creates a scannable structure.
Each page should cover one topic or purpose. If a page grows too large, consider splitting it into multiple pages.
Create connections between related content by linking to other pages in your knowledge base.
## Page tabs
Organize related content within a single page using tabs. Think of them like tabs in a spreadsheet—one page, multiple sections.
* Add tabs with the **+** button at the bottom of the editor
* Each tab has independent content and editing
* Great for meeting notes, project phases, or documentation sections
See how to create and manage page tabs.
## Page history
Every change to a page is tracked. You can see who edited what, when, and roll back to any previous version.
* Click the **clock icon** in the toolbar to open history
* Preview any past version before restoring
* Roll back with a single click—nothing is ever lost
See how to track changes and restore versions.
## Next steps
Organize content in multiple tabs.
Track changes and restore versions.
Learn about creating and managing spreadsheets.
Discover how to share pages with others.
# Sharing Resources
Source: https://docs.trilo.chat/knowledge-base/sharing
Share your knowledge base content with team members and external stakeholders
Trilo makes it easy to share your knowledge base resources with the right people. Whether you're collaborating with your team or sharing with external stakeholders, you have flexible options for controlling access.
## Internal Sharing
### Team Access
By default, resources are accessible to everyone who has access to the project:
* **Workspace members** see resources in projects they belong to
* **Project members** have full access to resources within their projects
* **Admins** can access all resources in the workspace
### Sharing Within Your Team
To share a resource with a teammate:
1. Send them the link directly (via chat, email, etc.)
2. Mention the resource in project chat
3. Link to it from another page
Simply copying the URL from your browser and sharing it works for internal sharing—team members with project access can open it directly.
## Public Sharing
Share resources with people outside your workspace using public links.
### Making a Resource Public
Navigate to the page, spreadsheet, or board you want to share.
Click the **Share** button in the top right corner.
Toggle **Public access** to on.
Copy the public link to share with anyone.
### Public Link Types
| Resource Type | Public Access |
| ---------------- | ---------------------------------- |
| **Pages** | View-only access to the document |
| **Spreadsheets** | View-only access to the data |
| **Boards** | View-only access to the whiteboard |
### Custom URLs
Make your public links more professional with custom URLs:
Click **Share** on your resource.
Enter a custom slug (e.g., `product-roadmap` instead of a random string).
Your new URL will be `your-workspace.trilo.chat/public/product-roadmap`.
Custom slugs must be unique within your workspace and can only contain letters, numbers, and hyphens.
### Managing Public Access
You can modify public access at any time:
* **Disable**: Toggle off public access to revoke the link
* **Change URL**: Update the custom slug (old links will stop working)
* **Regenerate**: Create a new random link if the current one was shared too widely
When you disable public access or change the URL, anyone with the old link will no longer be able to access the resource.
## Public Page Settings
When sharing pages publicly, you can customize what viewers see:
### Metadata
Set the information displayed when the link is shared on social media or messaging apps:
* **Title**: The page title or a custom title
* **Description**: A brief summary of the content
* **Image**: A preview image for link cards
### Appearance
* Choose whether to show the page title
* Select whether to display the last updated date
* Decide if you want to show the author
## Sharing Best Practices
Instead of random strings, use meaningful slugs like `api-documentation` or `brand-guidelines`. They're easier to share and look more professional.
Always review content before making it public. Check for sensitive information, incomplete sections, or internal comments.
Periodically review your public resources. Disable access for outdated content or resources no longer needed externally.
Only make resources public when necessary. For trusted external collaborators, consider inviting them as guests to specific projects instead.
## Guest Access
For more controlled external sharing, invite external users as guests.
### Inviting Guests
Click **Settings** in the sidebar.
Click on **Members**.
Enter the guest's email and select the **Guest** role.
Choose which specific projects the guest can access.
### Guest vs. Public Access
| Feature | Public Link | Guest Access |
| ------------------ | --------------- | ------------------------------- |
| **Authentication** | None required | Sign-in required |
| **Tracking** | Anonymous views | Named user activity |
| **Scope** | Single resource | Multiple resources in a project |
| **Interaction** | View only | Can comment and interact |
| **Revocation** | Change link | Remove guest access |
## Embedding Resources
Embed your public resources in external websites or documentation.
### Getting the Embed Code
1. Make the resource public (see above)
2. Click **Share** and select **Embed**
3. Copy the embed code (iframe)
4. Paste into your website's HTML
### Embed Options
* **Width/Height**: Adjust dimensions to fit your layout
* **Border**: Show or hide the frame border
* **Toolbar**: Show or hide editing tools (view-only for public)
Embedded resources update automatically when you edit the original resource in Trilo.
## Link Previews
When you share Trilo links in chat or other apps, they show rich previews:
* **Title**: The resource name
* **Description**: Brief content preview
* **Image**: Thumbnail or custom image
* **Type**: Icon showing whether it's a page, spreadsheet, or board
This helps recipients understand what they're clicking before opening the link.
## Security Considerations
Never make resources containing sensitive information public. This includes customer data, internal financials, passwords, API keys, or personal information.
Set a reminder to review public resources quarterly. Remove public access from resources that no longer need to be shared externally.
If you need to share multiple resources with external collaborators over time, guest access is more secure than multiple public links.
Public links can be shared by anyone who has them. If the content is sensitive, use guest access instead.
## Troubleshooting
* Check that public access is still enabled
* Verify the URL hasn't changed (custom slug update)
* Ensure the resource hasn't been deleted or archived
* Confirm the guest was added to the correct project
* Check that the invitation was accepted
* Verify the resource is in a project the guest has access to
* Update the metadata in sharing settings
* Wait for cache to refresh (can take a few minutes)
* Try sharing the link again after updating
## Next Steps
Understand access control in detail.
Learn how to add teammates and guests.
# Spreadsheets
Source: https://docs.trilo.chat/knowledge-base/spreadsheets
Create and manage tabular data with powerful spreadsheet features
Spreadsheets in Trilo let you work with structured data, create tables, and organize information in rows and columns. They're perfect for tracking data, creating lists, and managing information that fits a tabular format.
## Creating a Spreadsheet
Open a project and click on **Resources** in the navigation.
Click the **+ New** button.
Choose **Spreadsheet** from the dropdown menu.
Give it a descriptive name that reflects its contents.
## Working with Cells
### Entering Data
* **Click** any cell to select it
* **Type** to enter data directly
* **Tab** to move to the next cell
* **Enter** to move to the cell below
* **Arrow keys** to navigate between cells
### Selecting Cells
* **Single cell**: Click on the cell
* **Range**: Click and drag, or Shift + click
* **Column**: Click the column header
* **Row**: Click the row number
* **All cells**: Click the corner button or `Cmd/Ctrl + A`
### Cell Types
Cells automatically detect the type of data you enter:
| Type | Examples | Features |
| -------------- | ------------------- | --------------------------- |
| **Text** | Names, descriptions | Left-aligned |
| **Number** | 42, 3.14, -100 | Right-aligned, calculations |
| **Date** | 2024-01-15, Jan 15 | Date formatting |
| **Currency** | \$100, €50 | Currency symbols |
| **Percentage** | 50%, 0.5 | Percentage display |
### Formatting Cells
Select cells and use the toolbar to:
* **Bold**, **italic**, or **underline** text
* Change **text color** or **background color**
* Adjust **alignment** (left, center, right)
* Change **number format** (currency, percentage, date)
## Columns and Rows
### Adding Columns
* **Right-click** a column header and select **Insert column left/right**
* Click the **+** button at the end of the header row
### Adding Rows
* **Right-click** a row number and select **Insert row above/below**
* Click the **+** button at the bottom of the spreadsheet
### Resizing
* **Drag** the border between column headers to resize width
* **Drag** the border between row numbers to resize height
* **Double-click** a column border to auto-fit width to content
### Deleting
* **Right-click** a column header or row number
* Select **Delete column** or **Delete row**
### Reordering
* **Drag** column headers or row numbers to reorder
* Drop in the desired position
## Sorting and Filtering
### Sorting Data
Sort your data by any column:
1. Click the column header dropdown (arrow icon)
2. Select **Sort A to Z** or **Sort Z to A**
3. For numbers: **Sort smallest to largest** or vice versa
### Filtering Data
Show only the data you need:
1. Click the filter icon in a column header
2. Choose filter criteria:
* **Text filters**: Contains, starts with, equals
* **Number filters**: Greater than, less than, between
* **Date filters**: Before, after, between
3. Apply the filter to show matching rows
Combine filters on multiple columns for more specific results.
## Formulas
Use formulas to calculate values automatically.
### Basic Formulas
Start any formula with `=`:
| Formula | What it does |
| -------- | --------------- |
| `=A1+B1` | Add values |
| `=A1-B1` | Subtract values |
| `=A1*B1` | Multiply values |
| `=A1/B1` | Divide values |
### Common Functions
| Function | Example | Description |
| --------- | ----------------------- | ------------------- |
| `SUM` | `=SUM(A1:A10)` | Add up a range |
| `AVERAGE` | `=AVERAGE(B1:B10)` | Calculate average |
| `COUNT` | `=COUNT(C1:C10)` | Count numbers |
| `MAX` | `=MAX(D1:D10)` | Find largest value |
| `MIN` | `=MIN(D1:D10)` | Find smallest value |
| `IF` | `=IF(A1>10,"Yes","No")` | Conditional logic |
### Cell References
* **Relative**: `A1` — Changes when copied
* **Absolute**: `$A$1` — Stays fixed when copied
* **Mixed**: `$A1` or `A$1` — Partially fixed
## Importing and Exporting
### Import Data
Bring in data from other sources:
In your spreadsheet, click the **Import** button.
Select a CSV or Excel file from your computer.
Match the imported columns to your spreadsheet columns if needed.
Click **Import** to bring in the data.
Supported formats:
* **CSV** (Comma-separated values)
* **Excel** (.xlsx, .xls)
### Export Data
Share your data outside Trilo:
1. Click the **Export** button or **...** menu
2. Choose your format (CSV or Excel)
3. The file will download to your computer
## Collaboration
### Real-Time Editing
Multiple team members can work on the same spreadsheet:
* See other users' selections highlighted
* Watch changes appear in real-time
* Avatars show who's currently viewing
### Comments
Add comments to discuss specific cells:
1. Right-click a cell
2. Select **Add comment**
3. Type your comment and press Enter
4. Team members will see a indicator on the cell
## Keyboard Shortcuts
| Action | Shortcut |
| ----------------- | ----------------------- |
| Copy | `Cmd/Ctrl + C` |
| Paste | `Cmd/Ctrl + V` |
| Cut | `Cmd/Ctrl + X` |
| Undo | `Cmd/Ctrl + Z` |
| Redo | `Cmd/Ctrl + Shift + Z` |
| Select all | `Cmd/Ctrl + A` |
| Bold | `Cmd/Ctrl + B` |
| Delete content | `Delete` or `Backspace` |
| Edit cell | `F2` or `Enter` |
| Navigate | Arrow keys |
| Move to next cell | `Tab` |
## Best Practices
Always include a header row with clear column names. This makes your data easier to understand and improves filtering.
Use the same format within a column (e.g., all dates in the same format, consistent currency symbols).
Freeze header rows and key columns so they stay visible when scrolling through large datasets.
Instead of manually calculating totals or averages, use formulas. They update automatically when data changes.
## Next Steps
Learn about visual whiteboards.
Share spreadsheets with your team or externally.
# Migrate from Asana
Source: https://docs.trilo.chat/migrations/from-asana
Step-by-step guide to migrate your Asana workspace to Trilo
Moving from Asana to Trilo gives you project management plus built-in team chat, video calls, and AI coworkers. No more switching between Asana and Slack. This guide walks you through migrating your Asana workspace.
## Why Teams Switch from Asana
| Asana Limitation | Trilo Solution |
| ---------------------------------- | ---------------------------------------- |
| No real-time chat (requires Slack) | Built-in project channels and DMs |
| No video calls (requires Zoom) | Native video calls with AI transcription |
| Time tracking costs extra | Time tracking included |
| AI features require higher tiers | AI coworkers included in all plans |
| Per-user pricing (\$11-25/user) | Flat workspace pricing |
## Before You Start
[Sign up for Trilo](https://app.trilo.chat) and set up your workspace with Areas and Projects.
Identify which Asana teams become Trilo Areas, and which projects map to Trilo Projects.
Add team members to Trilo before migrating content.
## Exporting from Asana
### Export a Project as CSV
Navigate to the project you want to export.
Next to the project name, click the dropdown.
Choose **Export/Print** from the menu.
Select **CSV** as the export format.
Save the CSV file to your computer.
### Export Multiple Projects
Repeat the CSV export for each project you want to migrate. Asana doesn't offer bulk workspace exports on most plans.
Asana's export includes task name, assignee, due date, status, description, and custom fields. Attachments need to be downloaded separately.
### What Gets Exported
| Content Type | Export Quality |
| ------------------ | ---------------------------------- |
| **Task names** | Complete |
| **Descriptions** | Complete |
| **Due dates** | Complete |
| **Assignees** | As email/name |
| **Status/Section** | Complete |
| **Custom fields** | Complete |
| **Subtasks** | Separate rows |
| **Attachments** | Not included (download separately) |
| **Comments** | Not included |
## Importing to Trilo
### Recreating Projects
In Trilo, create an Area that corresponds to your Asana team (e.g., "Marketing", "Engineering").
Within the Area, create a Project for each Asana project you're migrating.
Set the project prefix (for task IDs), enable AI features, and configure visibility.
### Importing Tasks
For smaller projects (under 50 tasks), manual creation is often fastest:
Review the tasks in a spreadsheet application.
Use keyboard shortcut `T` for quick task creation.
Add assignees, due dates, priorities, and descriptions.
Use Kanban view to drag tasks into the right columns.
For larger projects:
Keep the CSV open alongside Trilo.
Don't migrate completed tasks unless you need the history.
Create all tasks for one status, then move to the next.
This is a good opportunity to clean up your task list. Only migrate tasks that are actually needed.
### Handling Subtasks
Asana's subtask model differs from Trilo:
| Asana Approach | Trilo Approach |
| -------------------------- | ------------------------------------ |
| Nested subtasks | Checklists within task descriptions |
| Subtasks as separate items | Related tasks linked in descriptions |
| Deep nesting | Flat structure with clear naming |
For simple subtasks, use Trilo's checklist feature in task descriptions:
```markdown theme={null}
## Subtasks
- [ ] First subtask
- [ ] Second subtask
- [ ] Third subtask
```
## Feature Mapping
| Asana Feature | Trilo Equivalent |
| ------------- | -------------------------------------------- |
| Projects | Projects |
| Teams | Areas |
| Tasks | Tasks |
| Sections | Statuses (Backlog, To Do, In Progress, Done) |
| Subtasks | Checklists or linked tasks |
| My Tasks | Filter by assignee |
| Goals | Project-level objectives |
| Timeline | Coming soon |
| Portfolios | Area overview |
## What You Gain by Switching
### Built-In Team Chat
Asana only has task comments. Trilo has:
* Project channels for team discussions
* Direct messages with teammates
* AI coworkers to chat with
* Real context alongside your tasks
### Video Calls Included
No more Zoom subscription needed:
* Start calls directly from chat
* AI transcription included
* Meeting notes become tasks automatically
* Screen sharing built-in
### AI That Does More
Asana's AI is limited to writing help. Trilo AI coworkers:
* Join team conversations
* Create tasks from discussions
* Manage task status updates
* Work on projects autonomously
### Simpler Pricing
| Team Size | Asana Starter | Trilo |
| --------- | ------------- | ---------- |
| 5 users | \$55/month | \$25/month |
| 10 users | \$110/month | \$25/month |
| 20 users | \$220/month | \$25/month |
## Migration Checklist
* [ ] Create Trilo workspace
* [ ] Map Asana teams → Trilo Areas
* [ ] Map Asana projects → Trilo Projects
* [ ] Invite team members
* [ ] Export CSV from each Asana project
* [ ] Create Area/Project structure
* [ ] Import active tasks (skip completed)
* [ ] Download and re-upload critical attachments
* [ ] Set up project channels for team chat
* [ ] Configure integrations (GitHub, etc.)
* [ ] Train team on Trilo's chat features
* [ ] Keep Asana read-only for 2-4 weeks
* [ ] Gather feedback
* [ ] Cancel Asana subscription
## Common Questions
Trilo uses AI coworkers instead of rule-based automations. Rather than setting up "when X happens, do Y" rules, you can ask AI coworkers to handle tasks. It's more flexible and requires no configuration.
No, Trilo generates new IDs based on project prefixes (e.g., PROD-1, PROD-2). You can reference old Asana IDs in task descriptions if needed for historical tracking.
Trilo focuses on List, Kanban, and Table views. Timeline features are on the roadmap. For now, use due dates and the Calendar view for scheduling visibility.
Mention related tasks in descriptions or use task links. Trilo keeps things simple rather than complex dependency chains.
## Next Steps
Master Trilo's task features.
Configure project channels.
Learn how AI can help your team.
Manage schedules and deadlines.
# Migrate from ClickUp
Source: https://docs.trilo.chat/migrations/from-clickup
Step-by-step guide to migrate from ClickUp to Trilo
Moving from ClickUp to Trilo gives you powerful features without the complexity. ClickUp has 100+ features and a learning curve to match. Trilo gives you what you need in a clean interface with built-in chat and AI coworkers. This guide walks you through the switch.
## Why Teams Switch from ClickUp
| ClickUp Limitation | Trilo Solution |
| ------------------------------- | -------------------------- |
| Overwhelming UI (100+ features) | Clean, focused interface |
| Steep learning curve | Productive in minutes |
| Chat requires Unlimited+ plan | Chat included in all plans |
| Features locked behind tiers | All features available |
| Per-user pricing | Flat workspace pricing |
## Before You Start
[Sign up for Trilo](https://app.trilo.chat) and set up your workspace.
Identify how ClickUp Spaces/Folders/Lists map to Trilo Areas/Projects.
Add team members before migrating content.
Decide what to migrate vs. what to leave behind.
## Structure Mapping
| ClickUp | Trilo |
| --------- | ---------------------------------- |
| Workspace | Workspace |
| Spaces | Areas |
| Folders | (Organizational grouping in Areas) |
| Lists | Projects |
| Tasks | Tasks |
| Docs | Pages |
## Exporting from ClickUp
### Export Tasks
Navigate to the content you want to export.
Find the three-dot menu or settings icon.
Choose **Export** from the options.
Select **CSV** for task data or **Text** for simple lists.
Select which fields to include in the export.
Save the file to your computer.
### Export Docs
Navigate to the ClickUp Doc you want to migrate.
Open the share/export menu.
Choose Markdown format for best compatibility.
Save and prepare for import to Trilo.
### What Gets Exported
| Content Type | Export Quality |
| ------------- | ------------------- |
| Task names | Complete |
| Descriptions | Complete |
| Due dates | Complete |
| Assignees | As names/emails |
| Custom fields | Complete |
| Comments | Partial |
| Attachments | Download separately |
| Docs | Markdown export |
## Importing to Trilo
### Setting Up Structure
Map your ClickUp Spaces to Trilo Areas.
Each ClickUp List becomes a Trilo Project.
Set prefixes, enable features, add team members.
### Migrating Tasks
Open in a spreadsheet and identify the data you need.
Use `T` shortcut for quick creation, or the full form for details.
Add assignees, due dates, priorities, descriptions.
Use Kanban view to drag tasks into columns.
Focus on active tasks. Don't migrate completed tasks unless you need the history. This is a good time to clean up.
### Migrating Docs
Navigate to your project and create a new Page.
Open your exported Markdown and copy the content.
Paste into the editor. Formatting will be preserved.
Fix any formatting issues and re-add images.
## Feature Comparison
### What's Simpler in Trilo
| ClickUp | Trilo |
| --------------------------- | ------------------------------------- |
| 15+ view types | 3 focused views (List, Kanban, Table) |
| Complex automations | AI coworkers that understand context |
| Nested spaces/folders/lists | Clean Areas → Projects structure |
| Feature overload | Essential features done well |
### What's Included in Trilo
| Feature | ClickUp | Trilo |
| -------------- | --------------------- | --------- |
| Tasks & boards | All plans | All plans |
| Docs | All plans | All plans |
| Real-time chat | Unlimited+ (\$7/user) | All plans |
| Whiteboards | Business (\$12/user) | All plans |
| Time tracking | Unlimited+ (\$7/user) | All plans |
| Booking links | Not available | All plans |
| AI coworkers | ClickUp Brain | Included |
## What You Gain by Switching
### Simplicity Without Sacrifice
ClickUp brags about having everything. But:
* 15 different views create analysis paralysis
* 50+ automations require extensive setup
* New team members need weeks of training
Trilo gives you the features that matter in an interface you can use immediately.
### Built-in Chat (All Plans)
ClickUp buries chat in higher tiers. Trilo includes:
* Project channels with every project
* Direct messages with team members
* AI coworkers you can chat with
* Voice and video calls
### Transparent Pricing
| Feature | ClickUp | Trilo |
| ------------- | --------------- | ---------- |
| Chat | \$7/user/month | Included |
| Time tracking | \$7/user/month | Included |
| Whiteboards | \$12/user/month | Included |
| **10 users** | $70-$180/month | \$25/month |
## Migration Checklist
* [ ] Create Trilo workspace
* [ ] Map ClickUp structure to Trilo
* [ ] Invite team members
* [ ] Export tasks and docs from ClickUp
* [ ] Identify what to migrate (skip the clutter)
* [ ] Create Areas and Projects
* [ ] Import active tasks
* [ ] Migrate important docs
* [ ] Download and re-upload key attachments
* [ ] Set up project chat channels
* [ ] Announce the switch
* [ ] Run ClickUp in read-only for 2 weeks
* [ ] Train team on Trilo's simpler interface
* [ ] Gather feedback
* [ ] Cancel ClickUp subscription
## Common Questions
Trilo uses AI coworkers instead of rule-based automations. Rather than configuring complex "if this then that" rules, AI coworkers understand context and can be asked to handle tasks naturally. Less setup, more flexibility.
Most teams only use 2-3 views regularly. Trilo's List, Kanban, and Table views cover 95% of use cases. If you find yourself using ClickUp's advanced views, you might be over-complicating your workflow.
Trilo supports standard fields (priority, due date, assignee, status). For additional data, use task descriptions or the attached spreadsheet features. Most custom fields are over-engineering.
Goals can be recreated as project objectives or tracked in Trilo pages. The migration is a good time to reassess which goals are actually being tracked and used.
## Next Steps
Master Trilo's focused task features.
Create docs without the complexity.
Chat that's included, not locked.
AI that does work, not just automations.
# Migrate from Microsoft Teams
Source: https://docs.trilo.chat/migrations/from-microsoft-teams
Step-by-step guide to migrate from Microsoft Teams to Trilo
Moving from Microsoft Teams to Trilo means escaping the Microsoft ecosystem complexity. Instead of navigating Teams, SharePoint, Planner, Loop, and Outlook, you get one workspace with chat, tasks, docs, calendar, and AI coworkers. This guide walks you through the switch.
## Why Teams Switch from Microsoft Teams
| Microsoft Teams Limitation | Trilo Solution |
| ------------------------------- | --------------------------- |
| Requires SharePoint for files | Built-in knowledge base |
| Requires Planner for tasks | Built-in task management |
| Requires Loop for collaboration | Built-in docs & whiteboards |
| Requires Outlook for calendar | Built-in calendar & booking |
| Copilot costs \$30/user extra | AI coworkers included |
| Complex licensing tiers | Simple flat pricing |
## Before You Start
[Sign up for Trilo](https://app.trilo.chat) and set up your workspace.
Identify how Teams teams/channels map to Trilo Areas/Projects.
Add team members to Trilo (they don't need Microsoft accounts).
Decide what to migrate vs. what to leave behind.
## Structure Mapping
| Microsoft Teams | Trilo |
| -------------------- | -------------------- |
| Teams (organization) | Workspace |
| Teams (groups) | Areas |
| Channels | Projects |
| Channel tabs | Project resources |
| Planner plans | Tasks |
| SharePoint files | Pages & Spreadsheets |
| Loop components | Pages |
## Exporting from Microsoft Teams
### Export Chat History (Limited)
Microsoft Teams chat export is limited. For compliance exports, you need admin access and eDiscovery tools. For most migrations:
We recommend a fresh start for chat. Old Teams conversations often include outdated context. Export for reference if needed, but start clean in Trilo.
### Export Files from SharePoint
In your Teams channel, click **Files**.
Click **Open in SharePoint** to access the full file library.
Select files and download them to your computer.
Upload files to your Trilo project resources.
### Export Planner Tasks
Go to tasks.office.com and find your plan.
Use the menu to export the plan to Excel.
Open the Excel file and identify tasks to migrate.
## Setting Up Trilo
### Creating Structure
Map your Teams "teams" to Trilo Areas.
Each Teams channel becomes a Trilo Project.
Invite people to relevant projects.
Enable AI features, set project prefixes.
### Migrating Content
**For Documents (from SharePoint):**
Get files from your Teams file storage.
For text documents, create Pages and paste content.
For other files, upload to task attachments or descriptions.
**For Tasks (from Planner):**
Open the Excel export of your Planner tasks.
Use the `T` shortcut for quick task creation.
Map Planner bucket → Trilo status, assignments, due dates.
## Feature Comparison
### One App vs. Five
| Need | Microsoft | Trilo |
| -------- | ---------------------------- | ------------------ |
| Chat | Teams | Built-in |
| Tasks | Planner (separate app) | Built-in |
| Docs | Loop/Word (separate apps) | Built-in Pages |
| Files | SharePoint (separate system) | Built-in resources |
| Calendar | Outlook (separate app) | Built-in |
| Video | Teams | Built-in |
| AI | Copilot (\$30/user extra) | Included |
### What's Better in Trilo
| Feature | Microsoft Teams | Trilo |
| ----------------- | ---------------------- | ------------ |
| Learning curve | Complex | Intuitive |
| App count | 5+ apps | 1 app |
| Performance | Resource-heavy | Lightweight |
| Microsoft account | Required | Not required |
| AI cost | \$30/user/month extra | Included |
| Search | Fragmented across apps | Unified |
## What You Gain by Switching
### Simplicity
Microsoft Teams requires:
* Teams for chat
* SharePoint for files (clunky interface)
* Planner for tasks (separate app)
* Loop for collaboration (yet another app)
* Outlook for calendar (separate app)
Trilo gives you one app where everything connects.
### AI Without the Tax
Microsoft Copilot costs \$30/user/month on top of your Microsoft 365 license:
* 10 users = \$300/month just for AI
* Requires premium Microsoft 365 licensing
* Still fragmented across apps
Trilo includes AI coworkers at no extra cost:
* Chat with AI in any conversation
* AI transcribes meetings
* AI creates tasks from discussions
* Works across your entire workspace
### Escape Ecosystem Lock-in
Microsoft Teams ties you to:
* Microsoft accounts for everyone
* SharePoint's complex permission system
* Microsoft 365 licensing
* The entire Microsoft ecosystem
Trilo works with any email, any calendar, any tools you choose.
## Migration Checklist
* [ ] Create Trilo workspace
* [ ] Map Teams structure to Trilo
* [ ] Invite team members
* [ ] Download files from SharePoint
* [ ] Export Planner tasks
* [ ] Set cutover date
* [ ] Create Areas and Projects
* [ ] Upload important documents
* [ ] Recreate active tasks
* [ ] Configure calendar integrations
* [ ] Test video calls
* [ ] Announce the switch
* [ ] Train team on Trilo features
* [ ] Keep Teams read-only for 2-4 weeks
* [ ] Gather feedback
* [ ] Plan Microsoft 365 license changes
## Tips for Microsoft-to-Trilo Migration
Microsoft's ecosystem evolved organically over decades. Your Trilo workspace can be simpler. Use Areas and Projects that match how your team actually works, not how Microsoft organized things.
Instead of exporting Outlook calendar data, just connect Google Calendar or Outlook to Trilo. Events sync automatically—no manual migration needed.
Pick a pilot team to migrate first. Learn from that experience before rolling out to the whole organization. This is especially important coming from Microsoft's complex ecosystem.
Teams users often don't realize how complex their setup is. Show them: "Instead of 5 apps, here's one." The simplification is usually the biggest selling point.
## Common Questions
Download files you need and upload them to Trilo. For ongoing storage, Trilo supports file attachments in tasks and resources. You don't need OneDrive's complexity.
Absolutely. Trilo is for team collaboration, not email. Keep using Outlook (or Gmail, or any email) for email. Trilo replaces Teams/SharePoint/Planner, not Outlook email.
Trilo has its own video calling. New meetings can be scheduled in Trilo. For existing calendar events with Teams links, they'll continue to work until you reschedule them as Trilo calls.
That's a separate decision. Trilo replaces the collaboration apps (Teams, SharePoint, Planner, Loop), not the productivity apps (Word, Excel, PowerPoint). Many teams keep Microsoft 365 for Office apps but stop using Teams.
## Next Steps
One place for all communication.
Tasks without Planner's limitations.
Docs without SharePoint's complexity.
AI that's included, not \$30/user extra.
# Migrate from Monday.com
Source: https://docs.trilo.chat/migrations/from-monday
Step-by-step guide to migrate from Monday.com to Trilo
Moving from Monday.com to Trilo gives you project management plus built-in chat, video calls, and AI coworkers—at a flat price that doesn't grow with your team. This guide walks you through migrating your Monday.com workspace.
## Why Teams Switch from Monday.com
| Monday.com Limitation | Trilo Solution |
| ------------------------------- | ---------------------------------- |
| No real-time chat | Built-in project channels and DMs |
| No video calls | Native video with AI transcription |
| Per-user pricing (\$12-18/user) | Flat \$25/month workspace fee |
| Features locked in tiers | All features available |
| Minimum 3 seats | No minimums |
## Before You Start
[Sign up for Trilo](https://app.trilo.chat) and create your workspace.
Identify how Monday.com workspaces/boards map to Trilo Areas/Projects.
Add team members to Trilo.
Focus on active boards; leave archived content behind.
## Structure Mapping
| Monday.com | Trilo |
| ---------- | --------------- |
| Workspace | Workspace |
| Folders | Areas |
| Boards | Projects |
| Items | Tasks |
| Updates | Comments + Chat |
| Workdocs | Pages |
## Exporting from Monday.com
### Export a Board
Navigate to the board you want to export.
Find the board menu in the top right.
Click **More actions** or **Export**.
Select **Export board to Excel** or CSV format.
Save the file to your computer.
### What Gets Exported
| Content Type | Export Quality |
| ---------------- | ------------------- |
| Item names | Complete |
| Column values | Complete |
| Status | Complete |
| People | As names |
| Dates | Complete |
| Numbers | Complete |
| Text columns | Complete |
| Updates/Comments | Not included |
| Files | Download separately |
Monday.com updates (comments) don't export. If you need them, screenshot or copy important conversations manually.
## Importing to Trilo
### Setting Up Structure
Map your Monday.com folders to Trilo Areas.
Each Monday.com board becomes a Trilo Project.
Set task prefixes, add team members, enable features.
### Migrating Items as Tasks
Review the Excel/CSV file in a spreadsheet app.
Use the `T` shortcut for quick task creation.
* Monday Status → Trilo Status
* Monday Person → Trilo Assignee
* Monday Date → Trilo Due Date
* Monday Priority → Trilo Priority
Copy relevant details from Monday.com text columns.
Monday.com's board structure can be complex. Use the migration as an opportunity to simplify—you don't need 20 columns when 5 will do.
### Migrating Workdocs
Navigate to the document.
Use export if available, or select all and copy.
In your project, click **+ New** → **Page**.
Paste and adjust formatting as needed.
## Feature Comparison
### What's Included in Trilo
| Feature | Monday.com | Trilo |
| -------------- | -------------------- | ------------------- |
| Tasks & boards | All plans | All plans |
| Docs | Limited | Full knowledge base |
| Real-time chat | Not available | Included |
| Video calls | Not available | Included |
| Time tracking | Pro (\$18/user) | Included |
| Gantt/Timeline | Standard (\$12/user) | Coming soon |
| Calendar view | Standard (\$12/user) | Included |
| AI assistant | Enterprise only | Included |
### Pricing Comparison
| Team Size | Monday Standard | Monday Pro | Trilo |
| --------- | --------------- | ----------- | ---------- |
| 5 users | \$60/month | \$90/month | \$25/month |
| 10 users | \$120/month | \$180/month | \$25/month |
| 20 users | \$240/month | \$360/month | \$25/month |
Plus, Monday.com has a 3-seat minimum. Trilo has no minimums.
## What You Gain by Switching
### Built-in Communication
Monday.com has updates on items, but no real-time chat. Trilo has:
* Project channels for team discussions
* Direct messages with teammates
* AI coworkers you can chat with
* Voice and video calls
### Pricing That Makes Sense
Monday.com's per-user pricing punishes growth:
* Add 5 team members = \$60-90/month more
* Features locked behind expensive tiers
* 3-seat minimum even for small teams
Trilo's flat pricing means your cost stays predictable.
### AI That Works
Monday.com restricts AI to Enterprise plans. Trilo includes AI coworkers that:
* Join team conversations
* Transcribe meetings
* Create tasks from discussions
* Work autonomously on projects
## Migration Checklist
* [ ] Create Trilo workspace
* [ ] Map Monday.com structure to Trilo
* [ ] Invite team members
* [ ] Export boards you need to migrate
* [ ] Download important files/attachments
* [ ] Create Areas and Projects
* [ ] Import active items as tasks
* [ ] Migrate important Workdocs
* [ ] Set up project channels for chat
* [ ] Configure any integrations
* [ ] Announce the switch to your team
* [ ] Demonstrate chat and video features
* [ ] Keep Monday.com read-only for 2 weeks
* [ ] Gather feedback
* [ ] Cancel Monday.com subscription
## Common Questions
Trilo uses AI coworkers instead of automation recipes. You describe what you want, and AI handles it—no need to configure complex trigger-action rules.
Trilo uses standard task properties (status, assignee, priority, due date). For additional data, use descriptions or create linked spreadsheets. Most custom columns add complexity without value.
Updates don't export from Monday.com. If specific conversations are important, screenshot or copy them before migrating. Going forward, use Trilo's chat for better conversation tracking.
Minimal. Trilo is designed to be intuitive. Most teams are productive within a day, compared to Monday.com's steeper learning curve.
## Next Steps
Master Trilo's task features.
Configure project channels.
See what AI can do for your team.
Manage schedules and events.
# Migrate from Notion
Source: https://docs.trilo.chat/migrations/from-notion
Step-by-step guide to migrate your Notion workspace to Trilo
Moving from Notion to Trilo gives you everything Notion offers—plus real-time team chat, video calls, task management, and AI coworkers. This guide walks you through migrating your Notion workspace.
## Why Teams Switch from Notion
| Notion Limitation | Trilo Solution |
| ---------------------------------- | ---------------------------------------- |
| No real-time chat (requires Slack) | Built-in team chat with channels and DMs |
| No video calls (requires Zoom) | Native video calls with AI transcription |
| Database-based tasks feel clunky | Purpose-built task management |
| Notion AI costs \$10/user extra | AI coworkers included in all plans |
| Per-user pricing scales up | Flat workspace pricing |
## Before You Start
[Sign up for Trilo](https://app.trilo.chat) and create your workspace. Set up your Areas and Projects structure.
Add team members to Trilo so they're ready when content arrives.
Not everything needs to come over. Focus on active pages and databases.
## Exporting from Notion
### Export Individual Pages
For a few important pages:
Navigate to the page you want to export.
In the top right corner, click the three-dot menu.
Choose **Export** from the dropdown.
Select **Markdown & CSV** for best compatibility with Trilo.
Save the exported file to your computer.
### Export Your Entire Workspace
For larger migrations:
Click **Settings & Members** in Notion's sidebar.
Click the **Settings** tab.
Find the **Export all workspace content** section.
Choose **Markdown & CSV** format.
Notion will email you a download link when ready.
Notion exports can take a while for large workspaces. You'll receive an email when it's ready.
### What Gets Exported
| Content Type | Export Quality |
| ----------------------- | ------------------------------------------------ |
| **Text & formatting** | Excellent - Markdown preserves most formatting |
| **Tables** | Good - Exported as CSV or Markdown tables |
| **Images** | Good - Downloaded as separate files |
| **Embeds** | Partial - Links preserved, embeds need re-adding |
| **Databases** | Good - Exported as CSV files |
| **Relations & Rollups** | Limited - Exported as text, not linked |
## Importing to Trilo
### Pages and Documents
Navigate to your project and click **+ New** → **Page**.
Open the `.md` file from Notion in a text editor.
Select all and copy (`Cmd/Ctrl + A`, then `Cmd/Ctrl + C`).
Paste into the Trilo editor. Formatting will be preserved.
Upload images that weren't embedded inline.
### Databases → Trilo Spreadsheets
For Notion databases that serve as data tables:
In Notion, export the database view as CSV.
In your project, click **+ New** → **Spreadsheet**.
Use the import feature or paste data directly.
Set column types and formatting.
### Databases → Trilo Tasks
For Notion databases used as task lists:
Export your task database from Notion.
Open the CSV and identify columns for title, status, assignee, due date.
Use the CSV as reference to create tasks in Trilo. For smaller lists, manual creation is often faster than importing.
Configure task statuses to match your workflow (Backlog, To Do, In Progress, Done).
Trilo's task management is purpose-built, not database-based. You'll find features like quick status changes, keyboard shortcuts, and AI assistance that make it faster than Notion's database approach.
## Feature Mapping
| Notion Feature | Trilo Equivalent |
| ----------------- | --------------------------- |
| Pages | Pages (Knowledge Base) |
| Databases (data) | Spreadsheets |
| Databases (tasks) | Tasks |
| Wikis | Organized Pages in Projects |
| Team spaces | Areas and Projects |
| Comments | Comments + Real-time Chat |
| Notion AI | AI Coworkers (included) |
## What You Gain by Switching
### Real-Time Team Chat
Notion only has async comments. Trilo has:
* Project channels for team discussions
* Direct messages with team members
* AI coworkers you can chat with
* Voice and video calls
### Better Task Management
Instead of database workarounds:
* Purpose-built task views (List, Kanban, Table)
* Quick keyboard shortcuts
* AI that can create and manage tasks
* Time tracking built-in
### AI That Does More
Notion AI helps with writing. Trilo AI coworkers:
* Join team conversations
* Transcribe meetings
* Create tasks from discussions
* Work autonomously on your projects
## Migration Checklist
* [ ] Create Trilo workspace
* [ ] Set up Areas and Projects structure
* [ ] Invite team members
* [ ] Identify pages/databases to migrate
* [ ] Export content from Notion
* [ ] Import critical pages first
* [ ] Set up task projects
* [ ] Configure integrations
* [ ] Test with pilot team
* [ ] Announce the switch to your team
* [ ] Keep Notion read-only for 2-4 weeks
* [ ] Gather feedback and adjust
* [ ] Archive or cancel Notion subscription
## Common Questions
Not directly, but CSV export/import works well for most use cases. For task databases, we recommend recreating them as Trilo Tasks to get the full benefit of purpose-built task management.
Yes, most formatting transfers well via Markdown. Headers, lists, bold, italic, code blocks, and tables all come over cleanly. Complex embeds may need to be re-added manually.
Trilo has its own integrations including GitHub, Gmail, Slack, and more. Check our [integrations page](/settings/integrations) for the full list.
Absolutely. Many teams migrate one project or team at a time. This is actually recommended for smoother transitions.
## Next Steps
Organize your workspace structure.
Learn about Pages, Spreadsheets, and Boards.
Discover what Trilo AI can do.
Configure your team communication.
# Migrate from Slack
Source: https://docs.trilo.chat/migrations/from-slack
Step-by-step guide to migrate your Slack workspace to Trilo
Moving from Slack to Trilo gives you team messaging plus tasks, docs, calendar, video calls, and AI coworkers—all in one workspace. Stop paying for Slack + Asana + Notion + Zoom + Calendly. This guide walks you through the switch.
## Why Teams Switch from Slack
| Slack Limitation | Trilo Solution |
| ------------------------------------- | ------------------------ |
| Just chat (need Asana for tasks) | Built-in task management |
| Just chat (need Notion for docs) | Built-in knowledge base |
| Just chat (need Zoom for video) | Built-in video calls |
| Just chat (need Calendly for booking) | Built-in booking pages |
| Per-user pricing scales up | Flat workspace pricing |
| Slack AI costs \$8.75/user extra | AI coworkers included |
## Migration Philosophy
Unlike document or task migrations, chat history migration is often **not recommended**. Here's why:
### Start Fresh vs. Import History
| Approach | When to Use |
| ------------------------ | ---------------------------------------------------- |
| **Fresh start** | Most teams - clean slate, no clutter |
| **Export for reference** | If you need to search old conversations occasionally |
| **Full import** | Rarely needed - only for compliance requirements |
Most teams find that a fresh start is actually better. Old Slack channels accumulate noise, outdated discussions, and context that's no longer relevant. Trilo gives you a chance to start clean.
## Before You Start
[Sign up for Trilo](https://app.trilo.chat) and set up your Areas and Projects.
Identify which Slack channels become Trilo Projects (each project has its own chat channel).
Add team members to Trilo.
Pick a date when the team will switch. Communicate it clearly.
## Exporting from Slack (Optional)
If you need to preserve chat history for reference:
### Standard Export (Admin)
Visit your workspace settings at **\[workspace].slack.com/admin**.
Click **Settings & Permissions** → **Workspace Settings**.
Click **Import/Export Data** in the sidebar.
Click the **Export** tab and select **Start Export**.
You'll receive an email when the export is ready.
### What Gets Exported
| Content Type | Free/Pro Plan | Business+/Enterprise |
| ---------------- | ------------- | -------------------- |
| Public channels | Yes | Yes |
| Private channels | No | Yes (with approval) |
| Direct messages | No | Yes (with approval) |
| Files | Links only | Links only |
Slack exports are JSON files. They're useful for searching old content but not for importing into other tools. Store them as archives.
## Setting Up Trilo Chat
### Channel Structure
In Trilo, chat is organized around Projects:
| Slack Concept | Trilo Equivalent |
| ---------------- | --------------------------------------------- |
| Public channels | Project channels (visible to project members) |
| Private channels | Private projects or DMs |
| DMs | Direct Messages |
| @channel | @everyone in project |
| Threads | Threaded replies (infinite nesting) |
### Creating Your Project Structure
Map Slack channel categories to Trilo Areas (e.g., "Marketing", "Engineering", "General").
Each Slack channel typically becomes a Trilo Project. The project automatically gets a chat channel.
Add relevant team members to each project.
Example mapping:
| Slack Channel | Trilo Structure |
| -------------------- | ----------------------------------- |
| #general | General Area → Company-wide Project |
| #engineering | Engineering Area → Main Project |
| #eng-frontend | Engineering Area → Frontend Project |
| #marketing | Marketing Area → Main Project |
| #marketing-campaigns | Marketing Area → Campaigns Project |
## Feature Comparison
### What's Similar
| Feature | Slack | Trilo |
| ------------------- | ----- | -------------------- |
| Real-time messaging | ✓ | ✓ |
| Threaded replies | ✓ | ✓ (infinite nesting) |
| Emoji reactions | ✓ | ✓ |
| File sharing | ✓ | ✓ |
| @mentions | ✓ | ✓ |
| Search | ✓ | ✓ |
| Mobile apps | ✓ | ✓ |
### What's Better in Trilo
| Feature | Slack | Trilo |
| ------------- | ---------------------------- | -------------------------------- |
| Tasks | Requires Asana/Jira | Built-in |
| Documents | Requires Notion/Confluence | Built-in |
| Video calls | Huddles (limited) or Zoom | Full video with AI transcription |
| Calendar | Requires Google/Outlook | Built-in with booking pages |
| AI assistants | Slack AI (\$8.75/user extra) | AI coworkers included |
| Pricing | Per-user | Flat workspace fee |
## What You Gain by Switching
### Everything in One Place
Instead of:
* Slack for chat
* Asana for tasks
* Notion for docs
* Zoom for video
* Calendly for scheduling
You get one workspace where chat, tasks, docs, video, and calendar all connect.
### AI Coworkers, Not Just Chatbots
Slack AI answers questions. Trilo AI coworkers:
* Join team conversations and provide insights
* Create tasks from discussions
* Transcribe meetings automatically
* Work on projects autonomously
### Simpler Pricing
| Team Size | Slack Pro + Tools | Trilo |
| --------- | ----------------- | ---------- |
| 5 users | \~\$100/month | \$25/month |
| 10 users | \~\$200/month | \$25/month |
| 20 users | \~\$400/month | \$25/month |
*Slack Pro + Asana + Notion + Zoom estimates*
## Migration Checklist
* [ ] Announce migration date to team
* [ ] Export Slack data (optional, for reference)
* [ ] Set up Trilo workspace structure
* [ ] Create all Areas and Projects
* [ ] Invite team members
* [ ] Post final message in Slack announcing move
* [ ] Set Slack to read-only or archive channels
* [ ] Send welcome message in Trilo
* [ ] Share quick-start tips with team
* [ ] Be active in Trilo to encourage adoption
* [ ] Answer questions and provide support
* [ ] Set up first team tasks
* [ ] Create initial documentation
* [ ] Schedule a video call using Trilo
* [ ] Gather feedback
* [ ] Make adjustments based on usage
* [ ] Consider archiving/canceling Slack
## Tips for Smooth Transition
Admins and team leads should be active in Trilo first. When people see important conversations happening in Trilo, they'll follow.
Parallel tools cause confusion. Set a firm date to stop using Slack. Two weeks of overlap is usually enough.
Show your team features Slack didn't have: built-in tasks, docs, video calls, AI coworkers. Make the switch feel like an upgrade.
Write a quick guide for your team covering: where to find things, how to create tasks from chat, how to start a video call.
## Common Questions
Direct import isn't supported, and we don't recommend it. Old chat history rarely provides value and clutters your new workspace. Export from Slack for reference if needed, then start fresh in Trilo.
Trilo has its own integrations including GitHub, Gmail, and more. The key difference: these integrations work with AI coworkers, so the AI can actually use them to do work.
You can connect Slack as a Trilo integration to send notifications to Slack channels. But for team communication, pick one tool to avoid confusion.
Focus on what they gain: no more tool switching, AI that actually helps, video calls without Zoom. The consolidation benefit usually wins people over.
## Next Steps
Learn Trilo's messaging features.
See how tasks work alongside chat.
Try built-in video with AI transcription.
See what AI can do in your workspace.
# Migration Guides
Source: https://docs.trilo.chat/migrations/overview
Step-by-step guides to migrate your team from other tools to Trilo
Ready to switch to Trilo? These guides walk you through migrating your team's data, workflows, and habits from your current tools.
## Choose Your Migration Path
Migrate pages, databases, and wikis from Notion to Trilo's knowledge base.
Transfer projects, tasks, and team structures from Asana.
Move your team communication and channels to Trilo Chat.
Migrate tasks, docs, and workflows from ClickUp.
Transfer boards, items, and automations from Monday.com.
Switch from Teams, SharePoint, and Planner to Trilo.
## Migration Overview
### What Can Be Migrated
| Data Type | Migration Method |
| ----------------------- | ---------------------------------------------- |
| **Documents & Pages** | Export → Import or copy/paste with formatting |
| **Tasks & Projects** | CSV export → Manual recreation or bulk import |
| **Files & Attachments** | Download → Upload to Trilo |
| **Team Members** | Invite via email (no data transfer needed) |
| **Chat History** | Export for reference (fresh start recommended) |
### What You'll Get in Trilo
When you migrate to Trilo, you consolidate multiple tools into one:
| Instead of... | Use Trilo's... |
| --------------------- | -------------------------------------------- |
| Notion (docs) | Knowledge Base - Pages, Spreadsheets, Boards |
| Asana/Monday (tasks) | Tasks - Kanban, List, Table views |
| Slack (chat) | Chat - Project channels, DMs, AI coworkers |
| Calendly (scheduling) | Calendar - Events, Booking pages |
| Zoom (video) | Built-in video calls with AI transcription |
## General Migration Tips
Before importing data, map out your Areas and Projects in Trilo. This makes organizing imported content much easier. Think about how your teams and projects naturally group together.
Don't migrate everything at once. Pick a pilot team or project, migrate them first, and learn from that experience before rolling out to the whole organization.
Old tools accumulate clutter. Instead of migrating everything, migrate only what's actively used. Leave behind outdated docs, completed tasks, and archived projects.
Keep your old tool accessible (read-only if possible) for 2-4 weeks after migration. This gives people time to adjust and reference old content if needed.
Tell your team when the migration is happening, why you're switching, and where to find things in Trilo. A simple announcement goes a long way.
## Migration Support
Need help with your migration?
* **In-app support**: Click the help icon for immediate assistance
* **Email**: Reach out to [support@trilo.chat](mailto:support@trilo.chat)
* **Community**: Ask questions in our [Discord community](https://discord.gg/trilo)
For enterprise migrations with large datasets, contact us for personalized migration assistance.
## Next Steps
Set up your Trilo workspace before migrating.
Get your team into Trilo before importing data.
# Billing & Subscription
Source: https://docs.trilo.chat/settings/billing
Manage your Trilo subscription, payments, and credits
This guide covers everything about managing your Trilo subscription, billing, and credits system.
## Accessing Billing
Click **Settings** in the sidebar.
Navigate to the **Billing** section.
Only workspace owners can access billing settings.
## Subscription Plans
### Available Plans
Trilo offers different plans to fit your team's needs:
| Plan | Best For | Key Features |
| -------------- | ------------------------ | -------------------------------- |
| **Free** | Small teams trying Trilo | Core features, limited members |
| **Pro** | Growing teams | More members, advanced features |
| **Team** | Larger organizations | Full features, priority support |
| **Enterprise** | Large enterprises | Custom limits, dedicated support |
### Plan Comparison
| Feature | Free | Pro | Team | Enterprise |
| ---------- | --------- | -------- | --------- | ---------- |
| Members | Limited | More | Unlimited | Custom |
| Storage | Basic | More | Large | Custom |
| AI credits | Limited | More | Abundant | Custom |
| Support | Community | Email | Priority | Dedicated |
| Features | Core | Advanced | Full | Custom |
## Managing Your Subscription
### Viewing Current Plan
In Billing settings, you'll see:
* Your current plan name
* Billing cycle (monthly/yearly)
* Next billing date
* Current usage vs. limits
### Upgrading Your Plan
Find the upgrade button in Billing.
Select the plan you want.
Monthly or yearly (yearly often has discounts).
Add or confirm payment method.
Complete the upgrade.
Upgrades take effect immediately.
### Downgrading Your Plan
Find plan options in Billing.
Choose the plan to downgrade to.
See what features you'll lose.
Downgrade takes effect at end of billing period.
Downgrading may result in losing access to features and hitting limits. Review impacts before confirming.
### Canceling Subscription
To cancel your paid subscription:
1. Go to **Settings > Billing**
2. Click **Cancel subscription**
3. Provide feedback (optional)
4. Confirm cancellation
After canceling:
* Access continues until the end of the billing period
* Workspace reverts to Free plan
* Data is preserved (within Free plan limits)
## Payment Methods
### Adding a Payment Method
Find this in Billing settings.
Add a new payment method.
Add credit card or other payment info.
The method is available for billing.
### Accepted Payment Methods
* Credit cards (Visa, Mastercard, Amex)
* Debit cards
* Other methods may vary by region
### Updating Payment Method
In Billing settings.
Update existing or add new method.
Choose which method to use for billing.
### Removing Payment Method
1. Find the payment method
2. Click **Remove**
3. Confirm removal
You can't remove the last payment method while on a paid plan.
## Credits System
### What Are Credits?
Credits power AI features in Trilo:
* AI coworker conversations
* Image generation
* Advanced AI capabilities
### Viewing Credit Balance
In Billing, see:
* Current credit balance
* Usage this month
* Included credits with your plan
* Additional credits purchased
### Purchasing Credits
If you need more credits:
Find Credits section in Billing.
Select credit package to purchase.
Credits are added immediately.
### Auto Top-Up
Automatically purchase credits when balance is low:
Toggle on in Credits settings.
When to trigger purchase (e.g., below 100 credits).
How many credits to purchase each time.
## Invoices and Receipts
### Viewing Invoices
Find past invoices:
1. Go to **Settings > Billing > Invoices**
2. See list of all invoices
3. Click any invoice to view/download
### Invoice Contents
Each invoice includes:
* Date and invoice number
* Plan charges
* Credit purchases
* Tax information
* Payment method used
### Downloading Receipts
* Click **Download** on any invoice
* PDF format for your records
* Contains all billing details
## Billing Information
### Company Details
For invoices, provide:
* Company name
* Billing address
* Tax ID (if applicable)
### Updating Billing Info
1. Go to Billing Information
2. Edit company details
3. Save changes
4. Future invoices use new info
## Usage & Limits
### Viewing Usage
See your current consumption:
| Metric | Where to Find |
| ------- | ---------------------------- |
| Members | Settings > Members |
| Storage | Settings > Billing > Usage |
| Credits | Settings > Billing > Credits |
### Approaching Limits
When nearing limits:
* You'll receive notifications
* Dashboard shows warnings
* Consider upgrading before hitting limits
### Exceeding Limits
What happens when you exceed limits:
* Some features may be limited
* Upgrade prompts appear
* Grace periods may apply
## Best Practices
Yearly billing usually saves 15-20% compared to monthly.
Keep an eye on AI credit consumption to avoid running out.
If you rely on AI features, auto top-up prevents interruption.
Ensure your payment method is current to avoid billing issues.
Check invoices periodically to understand your spending.
## Troubleshooting
* Check payment method is valid
* Ensure sufficient funds
* Try a different payment method
* Contact your bank if issues persist
* Only workspace owners can access billing
* Contact the workspace owner
* Check you're in the correct workspace
* Check spam folder for email receipts
* View all invoices in Billing settings
* Contact support if invoice is needed
* Review invoice details
* Check for usage-based charges
* Contact support for billing questions
## Getting Help
For billing questions:
* **Email**: [support@trilo.chat](mailto:support@trilo.chat)
* **In-app**: Help > Billing Support
* **Enterprise**: Contact your account manager
## Next Steps
Configure other workspace options.
Manage your personal account.
# Integrations
Source: https://docs.trilo.chat/settings/integrations
Connect external apps to supercharge your workspace with 100+ third-party tools
Trilo connects to the tools your team already uses—GitHub, Gmail, Slack, Shopify, and many more. Once connected, AI coworkers can interact with these services directly, and workflows can automate actions across them.
## Personal vs. workspace integrations
Trilo has two types of integrations, and they work differently:
| Type | Who can use it | Where it works | Examples |
| ------------- | ----------------------- | -------------------------- | --------------------------------- |
| **Personal** | Only you | Your DMs with AI coworkers | Gmail, LinkedIn, Google Calendar |
| **Workspace** | Anyone in the workspace | Project chats, workflows | GitHub, Instagram, Shopify, Slack |
**Personal integrations** are yours alone. When you connect Gmail, only you can ask AI coworkers to read or send emails from your account.
**Workspace integrations** are shared. When someone connects GitHub to a workspace, anyone in that workspace can use it—though admins control which projects have access.
## Available integrations
### Personal integrations
| App | What AI can do | Tools |
| ------------------- | --------------------------------------------------- | -------- |
| **Gmail** | Read, search, and send emails from your account | 25 tools |
| **Google Calendar** | Check availability, create events, manage schedules | 28 tools |
| **LinkedIn** | View connections, post updates, manage messages | 20 tools |
### Workspace integrations
| App | What AI can do | Tools |
| --------------------- | ------------------------------------------- | --------------------- |
| **GitHub** | Read repos, create issues/PRs, manage code | Repository-level |
| **Instagram** | Post content, manage business accounts | 15 tools |
| **Slack** | Send messages, read channels, post updates | Team messaging |
| **Linear** | Create and manage issues | Project management |
| **Shopify** | Check orders, manage products and inventory | Store operations |
| **WhatsApp Business** | Send and receive business messages | Customer messaging |
| **Outlook** | Email and calendar for Office 365 | Microsoft integration |
| **Intercom** | Manage support conversations | Customer support |
More integrations are added regularly. Check the integrations settings page for the current list.
## Connecting an integration
### Personal integrations
Click your avatar, then **Settings**.
Find the **Integrations** section and click the **Personal** tab.
Find the app you want and click **Connect**.
You'll be redirected to the app's login. Sign in and grant Trilo permission.
Chat with an AI coworker in your DMs and ask it to use the connected app.
### Workspace integrations
Click **Settings** in the sidebar, then **Integrations**.
Switch to view workspace-level integrations.
Find the app and click **Connect**. You'll authorize via OAuth.
For some integrations (GitHub, Instagram), you'll need to choose specific accounts or resources.
Choose which projects can use this integration.
## Project-level access
Workspace integrations aren't automatically available everywhere. Admins assign integrations to specific projects:
1. Open the project you want to configure
2. Go to **Project Settings > Integrations**
3. Add the workspace integrations this project should access
4. Configure any app-specific settings
### Why project-level control?
* **Security**: Not every project needs GitHub access
* **Relevance**: Marketing projects don't need code repositories
* **Clarity**: AI coworkers only see relevant tools
## Configuring integrations
Some integrations need extra configuration after connecting:
### GitHub
After connecting, choose which repositories the workspace can access:
* Click **Configure** on your GitHub integration
* Select specific repositories or grant access to all
* Each project can be configured to access different repos
### Instagram
Select which business accounts are available:
* Connect your Instagram business or creator account
* Choose which accounts projects can post from
* Configure posting permissions per project
### WhatsApp Business
Set up phone numbers for messaging:
* Connect your WhatsApp Business account
* Select which phone numbers to enable
* Assign numbers to projects that need them
### Shopify
Configure store access:
* Connect your Shopify store
* Select which stores are available (if you have multiple)
* Projects can access product, order, and inventory data
## Using integrations with AI
Once connected, AI coworkers can use integrations naturally in conversation:
**In project chat (workspace integrations):**
```
You: Check if there are any open issues on our GitHub repo labeled "urgent"
AI: I found 3 open issues labeled urgent...
```
**In DMs (personal integrations):**
```
You: What meetings do I have tomorrow?
AI: Checking your Google Calendar... You have 3 meetings scheduled...
```
**In workflows:**
Workflows can use any integration assigned to their project. The AI automatically has access to the connected tools.
## Managing integrations
### Viewing connected apps
Go to **Settings > Integrations** to see all connections:
* **Personal tab**: Your individual connections
* **Team tab**: Workspace-level connections
* **Status**: Shows whether each integration is active
### Disconnecting
To remove an integration:
1. Find it in the integrations list
2. Click the menu icon (three dots)
3. Select **Disconnect**
4. Confirm the removal
Disconnecting a workspace integration affects everyone. Workflows and AI coworkers will lose access to that app.
### Reconnecting
If an integration stops working (expired token, permission changes):
1. You'll see an error status on the integration
2. Click **Reconnect**
3. Re-authorize with the external app
4. Everything should work again
## Integration security
### What permissions do integrations request?
Each integration requests only the permissions it needs. You'll see exactly what's being requested during the OAuth flow.
### Who can see my data?
* **Personal integrations**: Only you and AI coworkers you chat with
* **Workspace integrations**: Project members can use them, but data access depends on the integration
### Can I revoke access?
Yes. Disconnect the integration in Trilo, and also revoke access from the connected app's settings (Google, GitHub, etc.) for extra certainty.
## Troubleshooting
The connection may have expired or permissions changed. Click **Reconnect** to re-authorize.
The integration might not be assigned to that project. Check **Project Settings > Integrations** and add it.
Try:
* Clearing browser cookies and cache
* Using a different browser
* Checking if pop-ups are blocked
* Verifying your account has the right permissions on the external app
Make sure:
* The integration is connected at the workspace level
* The integration is assigned to the workflow's project
* Any required configuration (repos, accounts) is set up
## Next steps
Use integrations in automated workflows.
Chat with AI that can use your connected apps.
# Notification Settings
Source: https://docs.trilo.chat/settings/notifications
Control how and when you receive notifications from Trilo
Notifications keep you informed about activity in your workspace. Configure them to stay updated without being overwhelmed.
## Notification Channels
Trilo can notify you through multiple channels:
| Channel | Description | Best For |
| ----------- | -------------------- | ------------------- |
| **In-app** | Alerts within Trilo | Real-time awareness |
| **Desktop** | System notifications | Immediate attention |
| **Mobile** | Push notifications | On-the-go updates |
| **Email** | Email summaries | Catching up later |
## Accessing Notification Settings
Click **Settings** in the sidebar.
Navigate to the **Notifications** section.
Adjust settings for each notification type.
## Notification Types
### Messages
Configure chat notification preferences:
| Setting | Options |
| ----------------- | ------------------------ |
| **All messages** | Notify for every message |
| **Mentions only** | Only when @mentioned |
| **Nothing** | No chat notifications |
"Mentions only" is a good balance—you're notified when you need to respond but not overwhelmed by every message.
### Direct Messages
DM notification settings:
* **All DMs**: Every direct message
* **Important only**: Only urgent/important DMs
* **Nothing**: No DM notifications
Most people keep DM notifications on, as they're more personal.
### Tasks
Task-related notifications:
| Event | Default |
| -------------------------------- | ------- |
| **Assigned to me** | On |
| **Task I'm assigned to updated** | On |
| **Due date approaching** | On |
| **Task completed** | Off |
| **Comments on my tasks** | On |
### Calendar
Calendar notifications:
| Event | Default |
| ------------------------- | ------- |
| **Event reminders** | On |
| **New event invitations** | On |
| **Event changes** | On |
| **Event cancellations** | On |
### Mentions
When someone @mentions you:
* **All channels**: Notify for any mention
* **DMs and assigned projects only**: Limit scope
* **Off**: No mention notifications
Turning off mention notifications may cause you to miss important messages directed at you.
## Channel-Specific Settings
### Email Notifications
Configure email frequency:
| Setting | Description |
| ----------------- | -------------------------------- |
| **Real-time** | Email immediately for each event |
| **Daily digest** | One summary email per day |
| **Weekly digest** | One summary email per week |
| **Off** | No email notifications |
### Email Content Options
Choose what's included in emails:
* **Full message content**: See message text in email
* **Summary only**: Just notification, open Trilo to see details
### Desktop Notifications
Browser/desktop notification settings:
* **Enable/disable**: Turn desktop notifications on or off
* **Sound**: Play notification sound
* **Preview**: Show message content in notification
**Enabling desktop notifications:**
1. Enable in Trilo settings
2. Allow in browser when prompted
3. Check system notification settings if issues
### Mobile Push Notifications
For the Trilo mobile app:
* **Enable/disable** all push notifications
* Configure by notification type
* Set quiet hours
## Quiet Hours
### Do Not Disturb
Set times when you don't want notifications:
Go to Notifications > Quiet Hours.
Choose start and end times.
Pick which days quiet hours apply.
Allow urgent notifications if desired.
**Example schedule:**
* Quiet hours: 6:00 PM - 8:00 AM
* Days: Every day
* Exceptions: Urgent messages
### Quick Mute
Temporarily pause all notifications:
1. Click the notification bell icon
2. Select **Mute** or **Do not disturb**
3. Choose duration (1 hour, until tomorrow, etc.)
4. Notifications pause until time expires
## Per-Channel Overrides
### Muting Specific Channels
Mute channels that are too noisy:
Navigate to the project or DM.
Find the mute or notification settings.
Choose muted, mentions only, or all.
### Project-Specific Settings
Each project can have its own notification settings:
1. Open project settings
2. Find Notifications section
3. Override default preferences
4. Settings apply only to this project
## Notification Management
### Clearing Notifications
Clear notification badges:
* **Single**: Click to open and mark as read
* **All**: Click "Mark all as read" in notification panel
### Notification History
View past notifications:
1. Click the bell icon
2. Scroll through notification history
3. Click any notification to jump to the source
### Unsubscribing
Stop notifications for specific items:
* **Threads**: Unfollow threads you're not interested in
* **Tasks**: Remove yourself from task watchers
* **Events**: Decline event invitations
## Best Practices
Use default settings initially. Adjust based on what's too much or too little.
For busy channels, switch to mentions-only to reduce noise.
Protect your off-work time with quiet hours. You can still check manually if needed.
Daily or weekly email digests catch you up without real-time interruption.
Some channels are informational but not urgent. Mute them to reduce distractions.
## Troubleshooting
* Check notification settings in Trilo
* Verify browser permissions
* Check device notification settings
* Ensure you're not in quiet hours
* Check if the channel is muted
* Switch to "mentions only" for busy channels
* Mute channels you don't need updates from
* Enable quiet hours
* Unfollow threads you're not involved in
* Allow notifications in browser settings
* Check system notification preferences
* Ensure browser is running
* Try a different browser
* Check spam/junk folder
* Verify email address in profile
* Check email notification settings
* Whitelist Trilo's email domain
## Next Steps
Customize your personal profile.
Configure workspace-level options.
# Profile Settings
Source: https://docs.trilo.chat/settings/profile
Manage your personal profile and account settings
Your profile settings control how you appear to others in Trilo and your personal preferences. This guide covers everything you can customize about your account.
## Accessing Profile Settings
Find your profile picture in the bottom-left of the sidebar.
Click **Settings** or **Profile** from the menu.
Use tabs or menu to find specific settings.
## Personal Information
### Display Name
Your name as shown to others:
* Used in messages, tasks, and activity
* Visible to all workspace members
* Can be your full name or preferred name
### Email Address
Your primary email:
* Used for login
* Receives notifications
* Can be changed (verification required)
### Profile Picture
Your avatar image:
**To change:**
1. Click on your current avatar
2. Upload a new image
3. Crop if needed
4. Save
**Recommendations:**
* Square images work best
* Minimum 200x200 pixels
* Clear photo of your face for recognition
### Bio
A short description about yourself:
* Visible to teammates
* Helpful for larger teams
* Include your role, expertise, or interests
## Account Settings
### Password
Manage your account password:
**Changing password:**
1. Go to Account settings
2. Click **Change password**
3. Enter current password
4. Enter new password twice
5. Save
**Password requirements:**
* Minimum 8 characters
* Mix of letters and numbers recommended
* Avoid common passwords
### Two-Factor Authentication
Add extra security:
Go to Account > Security.
Select authenticator app or SMS.
Follow the prompts to configure.
Store backup codes securely.
### Connected Accounts
Manage sign-in methods:
* **Google**: Sign in with Google
* **Email/Password**: Traditional login
You can have multiple methods connected.
## Time and Locale
### Timezone
Set your local timezone:
* Events show in your local time
* Affects due dates and scheduling
* Important for team coordination
**To change:**
1. Go to Settings > Time & Locale
2. Select your timezone
3. Save
### Language
Choose your interface language:
* Controls menu and UI text
* Content created by others stays in original language
### Date Format
Choose how dates display:
* **MM/DD/YYYY** (US format)
* **DD/MM/YYYY** (International format)
* **YYYY-MM-DD** (ISO format)
### Time Format
Select 12-hour or 24-hour time:
* **12-hour**: 3:00 PM
* **24-hour**: 15:00
## Display Preferences
### Theme
Choose your visual theme:
| Theme | Description |
| ---------- | ------------------------------- |
| **Light** | Bright, white background |
| **Dark** | Dark background, easier on eyes |
| **System** | Matches your device settings |
### Density
Control how compact the interface appears:
* **Comfortable**: More spacing, easier to read
* **Compact**: More information, less scrolling
### Sidebar
Configure sidebar behavior:
* **Always visible**: Sidebar stays open
* **Collapsible**: Can hide sidebar for more space
* **Auto-hide**: Hides when not in use
## Sessions
### Active Sessions
See where you're logged in:
* Device type and browser
* Location (approximate)
* Last activity time
### Managing Sessions
**Sign out everywhere:**
1. Go to Settings > Sessions
2. Click **Sign out all sessions**
3. Confirm
This logs you out on all devices except current one.
**Sign out specific session:**
1. Find the session in the list
2. Click **Sign out** next to it
3. That device is logged out
## Privacy Settings
### Online Status
Control your visibility:
* **Show as online**: Others see when you're active
* **Appear offline**: Hide your online status
### Read Receipts
Control read receipt sharing:
* **Enabled**: Others know when you've seen messages
* **Disabled**: Your read status is private
### Activity Status
Show what you're working on:
* Displays current activity to teammates
* Can be disabled for privacy
## Deleting Your Account
Account deletion is permanent. All your data will be lost.
### Before Deleting
Consider:
* Transfer ownership of workspaces you own
* Download any data you need
* Inform your team
### Deletion Process
Navigate to the danger zone.
Start the deletion process.
Enter your password and confirm.
Account deletion may take up to 30 days.
## Best Practices
A clear profile photo helps teammates identify you quickly in chats and documents.
Ensure your email is current to receive important notifications.
Two-factor authentication significantly improves your account security.
Wrong timezone settings cause scheduling confusion. Double-check yours.
Check active sessions and sign out any you don't recognize.
## Troubleshooting
* New email must be unique
* Verify access to new email
* Check for typos
* Contact support if issues persist
* Clear browser cache
* Try a different image format
* Ensure image meets size requirements
* Refresh the page
* Use password reset
* Try backup codes if 2FA enabled
* Contact support as last resort
## Next Steps
Configure your notification preferences.
Manage workspace-level settings.
# Workspace Settings
Source: https://docs.trilo.chat/settings/workspace-settings
Configure settings that apply to your entire workspace
Workspace settings control configuration that affects everyone in your workspace. These settings are managed by workspace owners and admins.
## Accessing Workspace Settings
Click **Settings** in the sidebar.
Navigate to **Workspace Settings** or **General**.
Adjust settings as needed.
Only workspace owners and admins can modify workspace settings.
## General Settings
### Workspace Name
Your workspace's display name:
* Shown in sidebar and emails
* Used in shared links
* Can be changed anytime
### Workspace URL
The unique identifier in your workspace URL:
**Format:** `your-workspace.trilo.chat`
Changing the URL breaks existing links. Notify your team before changing.
### Workspace Logo
Brand your workspace:
1. Click the logo area
2. Upload an image (square, 200x200+ pixels)
3. Logo appears in sidebar and notifications
### Description
A brief description of the workspace:
* Helps members understand the workspace purpose
* Visible in workspace info
* Optional but recommended
## Member Settings
### Default Role
Set the default role for new invitations:
| Option | Effect |
| ---------- | -------------------------- |
| **Member** | New people join as Members |
| **Guest** | New people join as Guests |
### Invitation Controls
Who can invite new members:
* **Admins only**: Only admins can invite
* **All members**: Anyone can invite
### Guest Access
Control guest features:
* **Enable/disable** guest invitations
* Set guest limitations
* Control guest project access
## Security Settings
### Password Requirements
Set password policies:
* Minimum length
* Complexity requirements
* Password expiration (if applicable)
### Two-Factor Authentication
Workspace-wide 2FA policies:
| Setting | Effect |
| ------------ | ------------------------ |
| **Optional** | Members choose to enable |
| **Required** | Everyone must use 2FA |
### Session Settings
Configure session behavior:
* **Session timeout**: Auto-logout after inactivity
* **Remember me duration**: How long sessions last
### Allowed Sign-in Methods
Control how people can sign in:
* Email/password
* Google
* Other SSO providers (if available)
## Default Preferences
### Default Timezone
Set the default timezone for new members:
* New members inherit this setting
* Can be overridden per user
* Affects scheduling defaults
### Default Language
Workspace default language:
* New members see this language
* Can be changed per user
## Integrations
### Connected Services
Manage workspace-wide integrations:
* **Google Calendar**: Sync configuration
* **Outlook**: Microsoft integration
* **Other services**: Based on your plan
### API Access
For advanced integrations:
* View API keys
* Generate new keys
* Manage access tokens
### Webhooks
Configure webhooks for external systems:
1. Go to **Settings > Integrations > Webhooks**
2. Add webhook URL
3. Select events to trigger
4. Save configuration
## AI Settings
### AI Features
Control AI coworker availability:
| Setting | Effect |
| --------------- | ------------------------------------- |
| **Enabled** | AI coworkers available workspace-wide |
| **Per-project** | Enable/disable per project |
| **Disabled** | No AI features |
### Custom AI Coworkers
Manage workspace AI coworkers:
* Create custom coworkers
* Configure their capabilities
* Set access permissions
## Storage & Data
### Storage Usage
View storage consumption:
* Files and attachments
* Resources and documents
* Current usage vs. limit
### Data Export
Export workspace data:
* Download your data
* Backup for records
* Format options (JSON, CSV)
### Data Retention
Configure how long data is kept:
* Message history
* Deleted items
* Activity logs
## Danger Zone
### Archive Workspace
Temporarily deactivate the workspace:
* Hides from view
* Preserves all data
* Can be restored later
### Delete Workspace
Deletion is permanent. All data will be lost forever.
Find this in the Danger Zone section.
Type the workspace name to confirm.
Verify your identity.
The workspace and all data are removed.
Only workspace owners can delete workspaces.
## Settings by Role
### What Each Role Can Configure
| Setting Area | Owner | Admin | Member |
| ----------------- | ----- | ------- | ------ |
| General settings | Yes | Yes | No |
| Member settings | Yes | Yes | No |
| Security settings | Yes | Limited | No |
| Billing | Yes | No | No |
| Integrations | Yes | Yes | No |
| Delete/Archive | Yes | No | No |
## Best Practices
Consider requiring 2FA for all members, especially for workspaces with sensitive data.
Configure defaults that work for most members. Individual users can customize their own settings.
For larger organizations, limit who can invite new members to maintain control.
As your team grows, revisit settings to ensure they still make sense.
If you configure non-standard settings, document them for other admins.
## Troubleshooting
* Verify you have Admin or Owner role
* Check if you're in the right workspace
* Contact the workspace owner
* Check for validation errors
* Ensure you clicked Save
* Try refreshing and re-entering
* Check your permissions
* Verify integration is properly configured
* Check API keys are valid
* Review integration-specific documentation
* Reconnect the integration if needed
## Next Steps
Manage your subscription and payments.
Understand access control.
# Task Assignments
Source: https://docs.trilo.chat/tasks/assignments
Assign tasks to team members and AI coworkers for effective collaboration
Task assignments help your team know who's responsible for what. In Trilo, you can assign tasks to human team members or AI coworkers, making it easy to distribute work effectively.
## Assigning Tasks
### When Creating a Task
1. Click **+ New Task**
2. Click the **Assignee** field
3. Select a team member or AI coworker from the dropdown
4. Complete the task creation
### On Existing Tasks
**From task detail:**
1. Open the task
2. Click the Assignee field (shows avatar or "Unassigned")
3. Select the new assignee
**From list/table view:**
1. Click the assignee column for any task
2. Select from the dropdown
3. Change saves automatically
**From Kanban view:**
1. Click the avatar on a card
2. Select the new assignee
## Assignee Options
### Team Members
Any member of the project can be assigned:
* Displays their name and avatar
* They'll receive notifications about the assignment
* Appears in their "My Tasks" view
### AI Coworkers
Assign to AI for automated assistance:
* Select any AI coworker from the dropdown
* AI can work on tasks based on their capabilities
* Activity shows AI-driven changes clearly
### Unassigned
Keep tasks unassigned when:
* The right person hasn't been identified yet
* It's a backlog item not yet ready for work
* You want someone to self-assign
## Notifications
When you assign a task:
### The Assignee Receives
* In-app notification about the assignment
* The task appears in their "My Tasks" view
* Email notification (if enabled in settings)
### Notification Content
Notifications include:
* Task title
* Who assigned it
* Link to open the task directly
## Self-Assignment
Team members can assign tasks to themselves:
1. Find an unassigned task
2. Click the assignee field
3. Select your own name
4. You're now responsible for the task
Self-assignment is great for teams that work from a shared backlog—members can pick up tasks as they have capacity.
## Changing Assignments
### Reassigning Tasks
To change who's responsible:
1. Click the current assignee
2. Select the new person
3. The change is logged in activity
### Why Reassign
Common reasons to reassign:
* Original assignee is unavailable
* Task requires different expertise
* Workload balancing
* Handoff during project phases
### Assignment History
The activity log tracks all assignment changes:
```
Jan 15, 3:00 PM - Alex reassigned this task from Sarah to Mike
Jan 12, 10:00 AM - Alex assigned this task to Sarah
```
## Assigning to AI Coworkers
AI coworkers can be assigned tasks just like human members.
### When to Assign to AI
* **Content creation**: Writing, editing, summarizing
* **Data analysis**: Processing information
* **Research**: Gathering information on topics
* **Routine tasks**: Repetitive work AI can handle
### How AI Handles Tasks
When assigned to an AI coworker:
1. The AI processes the task based on its capabilities
2. Updates appear in the task activity
3. AI may update status or add comments
4. You'll be notified of completion
### Reviewing AI Work
Always review AI-completed work:
* Check the activity log for AI changes
* Verify the quality of output
* Make any necessary adjustments
* Update status to Done when satisfied
## Bulk Assignments
Assign multiple tasks at once:
Use checkboxes in list or table view to select multiple tasks.
The bulk action toolbar appears.
Choose "Assign to..."
Pick the person or AI to assign all selected tasks to.
Bulk assignment is useful for:
* Redistributing workload
* Assigning new team member's first tasks
* Moving tasks during project transitions
## Workload Visibility
### Viewing Team Workload
See how tasks are distributed:
1. Filter by assignee to see individual loads
2. Use Table view to compare across team
3. Look for imbalances in assignment
### Balancing Work
Signs of imbalance:
* One person has many urgent tasks
* Many tasks are unassigned
* Some team members have nothing assigned
Solutions:
* Reassign tasks from overloaded members
* Have available members self-assign
* Review priorities and postpone lower items
## My Tasks View
Every team member has a personal task view:
### What It Shows
* All tasks assigned to you
* Across all projects you're in
* Sorted by due date or priority
* Filtered to active statuses by default
### Accessing My Tasks
* Click **My Tasks** in the sidebar
* Or filter any view to show tasks assigned to you
## Assignment Best Practices
Every task should have one clear owner. If multiple people are involved, create separate tasks or use collaborator mentions.
Assign based on who has the skills AND the availability to complete the task effectively.
Avoid assigning tasks that won't be worked on for weeks. Assign when work is ready to begin.
If an assignee hasn't made progress, check in. The task may need to be reassigned or clarified.
AI coworkers are great for specific task types. Match the task to the AI's capabilities for best results.
## Troubleshooting
* Check they're a member of the project
* They may need to be invited to the project first
* Verify they have the correct role/permissions
* Check their notification settings
* Verify email notifications are enabled
* Ensure the assignment saved (refresh and check)
* Verify the task description is clear
* Check if the AI coworker has the needed capabilities
* Some tasks require human intervention
## Next Steps
Learn more about AI capabilities for task completion.
Understand who can assign and be assigned tasks.
# Creating Tasks
Source: https://docs.trilo.chat/tasks/creating-tasks
Learn how to create new tasks and set them up for success
Creating tasks in Trilo is quick and flexible. Whether you're capturing a quick idea or setting up a detailed work item, this guide covers all the ways to create and configure tasks.
## Quick Task Creation
The fastest way to create a task:
Navigate to a project and click **Tasks** in the navigation.
Use the keyboard shortcut `T` or click **+ New Task**.
Type a clear, actionable title for your task.
Hit Enter to create the task with default settings.
The task is created immediately—you can add more details later.
## Detailed Task Creation
For tasks that need more information upfront:
Open the task creation form.
Enter a clear, descriptive title.
Expand the description field and add context, requirements, or acceptance criteria.
Configure status, priority, assignee, and due date.
Upload any relevant files or screenshots.
Click **Create** to add the task.
## Task Properties
### Title
Write clear, actionable titles that describe what needs to be done:
Good task titles start with a verb and are specific. Instead of "Homepage," write "Update homepage hero section with new messaging."
**Examples of good titles:**
* "Fix login button not responding on mobile"
* "Write documentation for API authentication"
* "Design icons for navigation menu"
* "Review and merge PR #142"
### Status
Choose the appropriate starting status:
| Status | When to Use |
| --------------- | -------------------------------------- |
| **Backlog** | Future work, not yet planned |
| **To Do** | Planned for upcoming work |
| **In Progress** | Starting work immediately |
| **Done** | Already completed (rare for new tasks) |
Most new tasks start as **To Do** or **Backlog**.
### Priority
Set the urgency level:
| Priority | Description | Examples |
| ---------- | ----------------------------------- | -------------------------------- |
| **Low** | Nice to have, can wait | Minor improvements, polish items |
| **Medium** | Standard work | Regular features, typical fixes |
| **High** | Important, should be addressed soon | Key features, significant bugs |
| **Urgent** | Critical, needs immediate attention | Production issues, blockers |
Avoid marking everything as urgent or high priority—it defeats the purpose of prioritization.
### Assignee
Assign the task to:
* **Specific team member**: The person responsible for completing the task
* **AI coworker**: For tasks that can be automated or AI-assisted
* **Unassigned**: When you don't know who should work on it yet
### Due Date
Set a deadline when the task needs to be completed:
1. Click the due date field
2. Select a date from the calendar
3. Optionally set a time for specific deadlines
**Due date tips:**
* Set realistic deadlines
* Consider dependencies on other tasks
* Leave buffer time for review
### Description
Use the description for:
* **Context**: Why this task matters
* **Requirements**: What needs to be done
* **Acceptance criteria**: How you'll know it's complete
* **Resources**: Links to designs, documentation, or references
The description supports markdown formatting:
```markdown theme={null}
## Overview
Brief explanation of the task.
## Requirements
- First requirement
- Second requirement
- Third requirement
## Resources
- [Design mockup](link)
- [Technical spec](link)
```
### Attachments
Add files to provide context:
1. Click the attachment area or drag files directly
2. Upload images, documents, or other files
3. Add multiple attachments if needed
Common attachments:
* Screenshots showing bugs or expected behavior
* Design files or mockups
* Reference documents
* Exported data files
## Creating Tasks from Different Views
### From List View
1. Click **+ New Task** at the top
2. Or click in the "Add task" area at the bottom of the list
3. Fill in details as needed
### From Kanban Board
1. Click **+** at the bottom of any column
2. The task is created with that column's status
3. Add details inline or open the full task view
### From Table View
1. Click the **+** button at the bottom
2. Fill in columns directly
3. Tab between fields for quick entry
## Creating Multiple Tasks
When you have several tasks to add:
### Batch Entry
1. Use the quick create shortcut (`T`)
2. Enter a title and press Enter
3. Immediately start typing the next title
4. Repeat for all tasks
5. Go back and add details as needed
### From Chat
When discussing tasks in project chat:
1. Mention creating a task
2. AI coworkers or team members can create tasks directly
3. The task is automatically linked to the conversation
## Task IDs
Every task gets a unique ID based on the project:
* **Format**: `[PREFIX]-[NUMBER]`
* **Example**: If your project prefix is "PROD", tasks are `PROD-1`, `PROD-2`, etc.
Use task IDs to:
* Reference tasks in chat or documentation
* Search for specific tasks
* Link tasks in descriptions
## Templates and Patterns
For recurring task types, establish patterns:
### Bug Reports
```
Title: [Bug] Brief description of the issue
Priority: Based on severity
Description:
- Steps to reproduce
- Expected behavior
- Actual behavior
- Screenshots/recordings
```
### Feature Requests
```
Title: [Feature] What the feature does
Priority: Based on importance
Description:
- User story / use case
- Requirements
- Design link (if available)
- Acceptance criteria
```
### Maintenance Tasks
```
Title: [Maintenance] Specific maintenance activity
Priority: Medium (unless critical)
Description:
- What needs to be done
- Why it's needed
- Any dependencies
```
## Best Practices
Start with a verb that describes what needs to happen. "Update," "Fix," "Create," "Review," "Implement" are all good choices.
Reserve urgent and high priorities for truly important items. If everything is urgent, nothing is.
If a task will take more than a day or two, consider breaking it into smaller subtasks.
Include enough detail in the description that someone else (or future you) can understand and complete the task.
Only set due dates when there's an actual deadline. Arbitrary dates create false urgency.
## Next Steps
Learn how to update and organize existing tasks.
Explore different ways to view your tasks.
# Managing Tasks
Source: https://docs.trilo.chat/tasks/managing-tasks
Update, organize, and track your tasks effectively
Once tasks are created, you'll need to manage them through their lifecycle. This guide covers everything from updating status to archiving completed work.
## Opening a Task
Click on any task to open its detail view, where you can:
* View and edit all task properties
* Add or update the description
* See and add attachments
* Review the activity history
* Add comments and updates
## Updating Task Status
### Quick Status Change
The fastest way to update status:
**In List View:**
* Click the status badge on any task
* Select the new status from the dropdown
**In Kanban View:**
* Drag the task card to a different column
* Drop it in the new status column
**In Table View:**
* Click the status cell
* Select from the dropdown
### Status Workflow
Tasks typically flow through these stages:
```
Backlog → To Do → In Progress → Done
```
But you can move tasks to any status at any time—there's no enforced linear workflow.
### Bulk Status Updates
Update multiple tasks at once:
Use checkboxes to select multiple tasks, or Shift+click for a range.
A toolbar appears with bulk action options.
Select "Change status" and pick the new status.
All selected tasks are updated.
## Editing Tasks
### Inline Editing
Edit properties directly from list or table views:
* Click on any editable field
* Make your change
* Click away or press Enter to save
### Full Edit Mode
For comprehensive editing:
1. Click on the task to open it
2. Edit any field in the detail view
3. Changes save automatically
### Editable Properties
| Property | How to Edit |
| --------------- | ------------------------------- |
| **Title** | Click and type |
| **Status** | Click dropdown or drag (Kanban) |
| **Priority** | Click dropdown |
| **Assignee** | Click and select team member |
| **Due Date** | Click and pick date |
| **Description** | Click description area and type |
## Task Activity
### Activity Log
Every task maintains a complete history:
* **Created**: When and by whom
* **Status changes**: Each transition with timestamp
* **Edits**: What changed and who made the change
* **Assignments**: When assignee changed
* **Comments**: Discussion thread
### Tracking Changes
The activity log shows:
```
Jan 15, 2:30 PM - Sarah moved this task to "In Progress"
Jan 15, 10:00 AM - Alex assigned this task to Sarah
Jan 14, 4:45 PM - Alex created this task
```
This helps you understand a task's journey and who's been involved.
## Organizing Tasks
### Sorting
Sort tasks in list and table views by:
* **Priority**: Urgent first or Low first
* **Due Date**: Upcoming first or furthest first
* **Created**: Newest or oldest first
* **Title**: Alphabetical
* **Status**: By workflow stage
### Moving Tasks Between Projects
To move a task to a different project:
Click to view task details.
Find the **...** menu.
Choose the destination project.
The task moves and gets a new ID based on the new project's prefix.
Moving a task changes its ID and may affect who has access to it based on project permissions.
## Archiving and Deleting
### Archiving Tasks
Archive completed tasks to keep your active list clean:
1. Open the task
2. Click **...** menu
3. Select **Archive**
Archived tasks:
* Are hidden from default views
* Can be viewed in the archive filter
* Can be restored if needed
* Preserve all history
### Viewing Archived Tasks
To see archived tasks:
1. Go to Tasks in your project
2. Click the filter options
3. Enable "Show archived" or filter by archived status
### Restoring Tasks
Bring archived tasks back:
1. View archived tasks (see above)
2. Open the archived task
3. Click **Restore**
4. The task returns to its previous status
### Deleting Tasks
Permanently remove a task:
1. Open the task
2. Click **...** menu
3. Select **Delete**
4. Confirm the deletion
Deleted tasks cannot be recovered. Use archive instead if you might need the task later.
## Due Date Management
### Setting Due Dates
1. Click the due date field
2. Pick a date from the calendar
3. Optionally add a specific time
### Viewing Due Dates
Tasks with due dates show indicators:
* **Upcoming**: Normal display
* **Due today**: Highlighted
* **Overdue**: Red indicator
### Changing Due Dates
* Click the existing due date
* Select a new date
* Or click **Clear** to remove the due date
## Attachments
### Adding Attachments
1. Open the task
2. Click the attachment area or drag files
3. Upload images, documents, or other files
### Managing Attachments
* **View**: Click to open/preview
* **Download**: Click download icon
* **Delete**: Click the X to remove
### Attachment Types
Supported files include:
* Images (PNG, JPG, GIF)
* Documents (PDF, Word, Excel)
* Code files
* Design files
## Working with Subtasks
For complex tasks, use checklists in the description:
```markdown theme={null}
## Checklist
- [ ] First subtask
- [ ] Second subtask
- [ ] Third subtask
```
Check items off as you complete them by clicking the checkbox.
## Keyboard Shortcuts
| Action | Shortcut |
| ------------------ | -------------- |
| New task | `T` |
| Open selected task | `Enter` |
| Close task detail | `Esc` |
| Navigate tasks | Arrow keys |
| Select task | `Space` |
| Quick edit title | Click and type |
## Best Practices
Change task status as you start and finish work. This keeps everyone informed and makes reporting accurate.
Unless a task was created by mistake, archive rather than delete. You never know when you'll need to reference past work.
Regularly review your tasks. Update outdated descriptions, adjust due dates, and archive completed work.
When you need context on a task, check the activity log to see what's happened and who's been involved.
## Next Steps
Master the different ways to view your tasks.
Learn about task assignment features.
# Tasks Overview
Source: https://docs.trilo.chat/tasks/overview
Manage your team's work with powerful task tracking and collaboration features
Tasks in Trilo help your team track work from start to finish. Create tasks, assign them to team members (human or AI), set priorities and due dates, and track progress through multiple views.
## Task Basics
Every task in Trilo includes:
* **Title**: A clear description of what needs to be done
* **Status**: Where the task is in your workflow
* **Assignee**: Who's responsible for completing the task
* **Priority**: How urgent or important the task is
* **Due date**: When the task should be completed
* **Description**: Additional details and context
## Task Statuses
Trilo uses a simple, effective workflow with four statuses:
| Status | Description | When to Use |
| --------------- | --------------------------- | ------------------------------------- |
| **Backlog** | Future work not yet planned | Ideas, future features, nice-to-haves |
| **To Do** | Planned but not started | Work scheduled for upcoming sprints |
| **In Progress** | Currently being worked on | Active work items |
| **Done** | Completed | Finished tasks |
## Views
Access tasks through multiple views to match how you like to work:
Traditional list format showing all tasks with key details in rows.
Visual board with columns for each status. Drag tasks to update status.
Spreadsheet-like view with sortable, filterable columns.
## Project-Based Organization
Tasks belong to projects, making it easy to organize work:
* Each project has its own task list
* Tasks get unique IDs based on project prefix (e.g., `PROD-1`, `PROD-2`)
* Filter and view tasks across projects or within a single project
* Project members can see and manage tasks in their projects
## Task Features
### Assignments
Assign tasks to:
* **Team members**: Any human member of the project
* **AI coworkers**: Delegate to AI for automated task completion
* **Unassigned**: Keep tasks in the backlog for later assignment
### Priorities
Set importance levels:
* **Low**: Nice to have, can wait
* **Medium**: Standard importance
* **High**: Important, should be addressed soon
* **Urgent**: Critical, needs immediate attention
### Due Dates
* Set specific due dates for deadlines
* Tasks approaching due dates are highlighted
* Overdue tasks are clearly marked
### Descriptions
Add rich details to tasks:
* Formatted text with markdown
* Checklists for subtasks
* Links to related resources
* Code snippets if needed
### Attachments
Add files and screenshots:
* Upload relevant documents
* Add screenshots for context
* Reference images for visual tasks
### Activity timeline
Track everything that happens to a task:
* See every status, priority, and assignee change
* View exactly who made each change (human or AI)
* Roll back to undo changes when needed
* Complete audit trail with before/after values
Learn about tracking and rolling back task changes.
## AI Integration
Trilo's AI coworkers can help with tasks:
* **AI as assignee**: Assign tasks to AI coworkers for automated completion
* **AI-created tasks**: AI can create tasks during conversations
* **AI suggestions**: Get recommendations for task breakdown
When AI completes a task or makes changes, the activity log shows exactly what was done and by which AI coworker.
## Quick Actions
Speed up your workflow with quick actions:
* **Keyboard shortcut**: Press `T` in a project to create a new task
* **Quick status update**: Click status badges to change directly
* **Bulk actions**: Select multiple tasks to update together
## Getting Started
Open a project and click **Tasks** in the navigation.
Click **+ New Task** or press `T`.
Add a title, set status and priority, and assign to a team member.
Switch between List, Kanban, or Table view to find what works for you.
## Next Steps
Learn how to create and configure tasks.
Discover how to update and organize tasks.
Track changes and roll back when needed.
Master different views and filtering options.
# Task Activity
Source: https://docs.trilo.chat/tasks/task-activity
Track every change to a task and roll back when needed
Every task keeps a complete record of what happened to it—who changed what, when, and why. You can see the full timeline and even undo changes by rolling back to earlier states.
## Viewing task activity
1. Click any task to open its details
2. Look for the **Timeline** or **Activity** tab
3. Scroll through the history of changes
The timeline shows everything in reverse chronological order, with the most recent changes at the top.
## What gets tracked
Every modification creates an activity entry:
| Change type | What's recorded |
| ------------------- | --------------------------------------------- |
| **Status** | From "To Do" → "In Progress" → "Done" |
| **Priority** | Low, Medium, High, Urgent changes |
| **Assignee** | When someone takes over or hands off the task |
| **Due date** | Date changes and removals |
| **Title** | Renames and edits |
| **Description** | Content updates |
| **Archive/restore** | When tasks are archived or brought back |
### Who made changes
Each entry shows exactly who made the change:
* **Team members**: Profile picture and name
* **AI coworkers**: AI avatar and name
* **System**: Automated changes (like scheduled updates)
For AI changes, you'll also see which tool or action triggered the modification.
## Reading the timeline
### Compact view
By default, activity shows in a compact format:
* **Timestamp**: "2h" (2 hours ago), "5m" (5 minutes), "now"
* **Avatar**: Who made the change
* **Summary**: "Updated status, priority"
* **Badge**: Number of fields changed
Click any entry to expand it and see the full details.
### Expanded view
When you expand an entry, you see:
* **Exact timestamp**: "Nov 10, 2:30 PM"
* **Field-by-field changes**: Status: In Progress → Done
* **Before/after values**: Crossed-out old value, highlighted new value
## Rolling back changes
Made a mistake? You can undo task changes:
Scroll through the timeline to find the activity you want to revert.
Hover over the entry—a rollback button appears on the right.
Review what will change and optionally add a note explaining why.
The task returns to its state before that change was made.
### What can be rolled back
* **Field updates**: Status, priority, assignee, dates, etc.
* **Description changes**: Content modifications
### What can't be rolled back
* **Task creation**: You can't un-create a task (archive it instead)
* **Already rolled-back changes**: Can't roll back a rollback
Rolling back creates a new activity entry, so there's always a complete audit trail. Nothing is hidden or deleted.
## Activity from AI coworkers
When AI coworkers modify tasks, the activity timeline shows:
* Which AI made the change
* What tool was used (e.g., "task\_update")
* The AI's reasoning (if available)
This makes it easy to understand why changes happened, even when you weren't watching.
### AI-created tasks
Tasks created by AI coworkers show:
* "Created by \[AI name]"
* Which conversation or workflow triggered the creation
* All the initial field values
## Real-time updates
Activity updates live. If someone changes a task while you're viewing it:
* New entries appear at the top of the timeline
* No need to refresh
* You see changes as they happen
## Time tracking integration
If your workspace uses time tracking, time entries appear in the same timeline as other activity. You'll see:
* When time was logged
* How long the work session lasted
* Who tracked the time
This gives you a complete picture of both changes and effort.
## Filtering and searching
For tasks with lots of activity:
* **Scroll** through the timeline chronologically
* **Look at avatars** to find changes by a specific person
* **Read summaries** to identify particular types of changes
* **Check timestamps** to find activity from a specific period
## Activity retention
Trilo keeps task activity indefinitely. You can always see the complete history of a task from creation to present.
## Tips
If you're about to make significant updates, scan the recent activity first. Someone else might already be working on it.
When handing a task to someone else, point them to the activity timeline. It's faster than explaining everything.
Activity can't be edited or deleted. If there's ever a question about what happened, the timeline is the source of truth.
The optional rollback note helps future you (and your team) understand why you undid a change.
## Troubleshooting
Very recent changes might take a moment to appear. If you're editing rapidly, Trilo batches activity to avoid cluttering the timeline with every keystroke.
Some activities can't be rolled back—like the initial creation of a task. The rollback button only appears for undoable changes.
Not all AI actions include detailed reasoning. If you need more context, check the conversation where the AI was working.
## Next steps
Learn how to update and organize tasks.
Work with AI that can manage tasks.
# Views and Filters
Source: https://docs.trilo.chat/tasks/views-and-filters
Customize how you see and organize your tasks with views and filters
Trilo offers multiple ways to view and filter your tasks, helping you focus on what matters most and work the way you prefer.
## Task Views
Switch between views using the view selector at the top of your Tasks section.
### List View
A clean, straightforward list of all tasks:
* **Best for**: Scanning tasks quickly, bulk operations
* **Shows**: Title, status, priority, assignee, due date
* **Sort by**: Click column headers to sort
**Features:**
* Compact view with all key information
* Checkboxes for bulk selection
* Click any row to open task details
* Inline editing for quick updates
### Kanban Board
Visual columns representing each status:
* **Best for**: Visualizing workflow, drag-and-drop updates
* **Shows**: Task cards in status columns
* **Columns**: Backlog, To Do, In Progress, Done
**Features:**
* Drag tasks between columns to change status
* See work-in-progress at a glance
* Cards show title, priority, assignee, due date
* Collapse/expand columns as needed
Kanban view is great for daily standups—you can quickly see what's in progress and what's blocked.
### Table View
Spreadsheet-style view with customizable columns:
* **Best for**: Detailed analysis, data-heavy management
* **Shows**: All task fields in columns
* **Features**: Sort, filter, and customize columns
**Features:**
* Resize columns by dragging
* Sort by clicking headers
* Hide/show columns
* Filter directly in column headers
* Export options
## Filtering Tasks
Focus on specific tasks using filters.
### Quick Filters
Common filters available with one click:
| Filter | What it shows |
| -------------- | ----------------------------- |
| **All** | Every task in the project |
| **My tasks** | Tasks assigned to you |
| **Unassigned** | Tasks without an assignee |
| **Urgent** | Only urgent priority tasks |
| **Due soon** | Tasks with upcoming due dates |
| **Overdue** | Tasks past their due date |
### Filter by Status
Show tasks in specific statuses:
* **Backlog only**: Future work
* **To Do only**: Planned work
* **In Progress only**: Active work
* **Done only**: Completed work
* **Multiple**: Select multiple statuses
### Filter by Priority
Focus on tasks by importance:
* **Urgent**: Critical items
* **High**: Important items
* **Medium**: Standard items
* **Low**: Nice-to-haves
* **Multiple**: Select multiple priorities
### Filter by Assignee
See tasks assigned to specific people:
* **Me**: Your tasks
* **Specific member**: Any team member
* **AI coworker**: Tasks assigned to AI
* **Unassigned**: Tasks without owners
### Filter by Due Date
Find tasks based on deadlines:
* **Due today**: Tasks due today
* **Due this week**: Tasks due within 7 days
* **Due this month**: Tasks due within 30 days
* **Overdue**: Past due date
* **No due date**: Tasks without deadlines
* **Custom range**: Specific date range
### Combining Filters
Apply multiple filters together:
**Example combinations:**
* "My tasks" + "In Progress" = Your active work
* "Urgent" + "Unassigned" = Critical tasks needing owners
* "Due this week" + "To Do" = Upcoming work to start
## Sorting Tasks
Change the order tasks appear in list and table views.
### Sort Options
| Sort by | Description |
| ------------ | ------------------------------------ |
| **Priority** | Urgent → Low or Low → Urgent |
| **Due date** | Soonest → Latest or Latest → Soonest |
| **Created** | Newest → Oldest or Oldest → Newest |
| **Updated** | Recently updated first |
| **Title** | Alphabetical A-Z or Z-A |
| **Status** | By workflow stage |
### How to Sort
**In List View:**
* Click any column header to sort
* Click again to reverse order
* Arrow indicates sort direction
**In Table View:**
* Click column headers
* Or use the sort menu for more options
## Saved Views
Save your filter and sort combinations for quick access.
### Creating a Saved View
Apply the filters and sorting you want to save.
Click the save icon or "Save current view."
Give it a descriptive name like "My Urgent Tasks" or "This Sprint."
The view appears in your view list.
### Using Saved Views
* Click the view name in the dropdown
* All your filters and sort options are applied instantly
* Great for views you use daily
### Managing Saved Views
* **Edit**: Update filters and re-save
* **Rename**: Change the view name
* **Delete**: Remove views you no longer need
## Cross-Project Views
See tasks across multiple projects:
### Workspace Task View
Access from the main navigation to see:
* All tasks you're assigned to
* Tasks across all your projects
* Filtered by workspace
### My Tasks
Your personal task list showing:
* Every task assigned to you
* Organized by project
* Sortable and filterable
## View Customization
### Column Configuration (Table View)
Choose which columns to display:
1. Click the column settings icon
2. Check/uncheck columns to show/hide
3. Drag to reorder columns
4. Save your configuration
Available columns:
* Title
* Status
* Priority
* Assignee
* Due Date
* Created Date
* Updated Date
* Task ID
### Compact vs. Comfortable
Some views offer density options:
* **Compact**: More tasks visible, less detail
* **Comfortable**: More spacing, easier to read
* **Default**: Balanced view
## View Tips and Tricks
Begin your day by filtering to your assigned tasks. This gives you a clear picture of your workload.
The Kanban board makes status changes visual and intuitive. Great for team visibility.
When you need to update many tasks at once, table view with checkboxes is the fastest.
If you frequently check the same filtered view, save it for one-click access.
Hide completed tasks to focus on active work. Include Done when you need to review completed items.
## Keyboard Shortcuts
| Action | Shortcut |
| --------------------- | -------------- |
| Switch to List view | `1` |
| Switch to Kanban view | `2` |
| Switch to Table view | `3` |
| Clear filters | `Esc` |
| Search tasks | `Cmd/Ctrl + F` |
## Best Practices
* **Planning**: List or Table view
* **Daily work**: Kanban or My Tasks
* **Reporting**: Table view with exports
Set your default view to show relevant, active work. Hide done tasks and archive completed work.
With many tasks, filtering is faster and more reliable than scrolling through everything.
As projects evolve, update your saved views to match current needs.
## Next Steps
Learn about assigning tasks effectively.
Discover how AI can help with task management.
# Areas and Projects
Source: https://docs.trilo.chat/workspaces/areas-and-projects
Organize your workspace with areas and projects for maximum efficiency
Within your workspace, areas and projects create the organizational structure for your work. Understanding how to use them effectively is key to keeping your team organized.
## Organizational Hierarchy
Trilo uses a three-level structure:
```
Workspace
└── Areas (categories)
└── Projects (where work happens)
├── Tasks
├── Resources
├── Chat
└── Calendar
```
## Areas
### What Are Areas?
Areas are high-level categories that group related projects. Think of them as folders or departments within your workspace.
**Example areas:**
* Engineering
* Marketing
* Operations
* Client Projects
* Product
### Creating an Area
Look at the navigation sidebar.
Find the add button near the Areas section.
Enter a clear, descriptive name.
Your area is created and ready for projects.
### Area Settings
Each area has settings you can configure:
| Setting | Description |
| --------------- | ----------------------------------------------- |
| **Name** | The area's display name |
| **Description** | Optional description of what this area contains |
| **Icon/Color** | Visual customization for easy identification |
### Managing Areas
#### Renaming
1. Right-click the area name
2. Select **Rename**
3. Enter the new name
4. Press Enter
#### Reordering
Drag areas in the sidebar to reorder them.
#### Archiving
For areas no longer active:
1. Right-click the area
2. Select **Archive**
3. Archived areas are hidden but preserved
## Projects
### What Are Projects?
Projects are where your actual work happens. Each project contains:
* **Tasks**: Work items to complete
* **Resources**: Knowledge base content (pages, spreadsheets, boards)
* **Chat**: Project-specific communication channel
* **Calendar**: Project-related events
### Creating a Project
Find the area where you want to create a project.
Click the add button within the area.
Enter name, prefix, and other settings.
Your project is ready to use.
### Project Settings
| Setting | Description |
| --------------- | ------------------------------------------------- |
| **Name** | Project's display name |
| **Prefix** | Short code for task IDs (e.g., "PROD" for PROD-1) |
| **Description** | What this project is about |
| **Due date** | Optional project deadline |
| **Status** | Active, Completed, or Archived |
| **AI features** | Enable/disable AI coworkers for this project |
### Project Prefix
The prefix creates unique task IDs:
* Set a 2-4 character prefix
* Tasks get IDs like `PROD-1`, `PROD-2`
* Makes tasks easy to reference in chat and docs
**Good prefix examples:**
* PROD (Product)
* MKT (Marketing)
* ENG (Engineering)
* CLIENT (Client project)
### Managing Projects
#### Renaming
1. Open project settings
2. Edit the name field
3. Save changes
#### Moving to Another Area
1. Open project settings
2. Find the **Area** field
3. Select the new area
4. Save changes
#### Archiving
For completed projects:
1. Open project settings
2. Change status to **Archived**
3. Or right-click and select **Archive**
Archived projects:
* Are hidden from normal view
* Preserve all data and history
* Can be restored later
#### Deleting
Deleting a project removes all its tasks, resources, and chat history permanently.
1. Open project settings
2. Find **Delete project**
3. Confirm deletion
## Navigating Projects
### Sidebar Navigation
* Areas listed in the sidebar
* Expand areas to see projects
* Click project name to open it
* Star projects for quick access
### Within a Project
After opening a project, use the navigation to access:
* **Overview**: Project summary
* **Tasks**: Task management
* **Resources**: Knowledge base
* **Chat**: Project channel
* **Calendar**: Project events
### Quick Access
**Starred projects** appear at the top:
1. Right-click any project
2. Select **Add to favorites** or click the star icon
3. Project appears in quick access section
## Organizing Your Workspace
### By Department/Team
```
Workspace
├── Engineering
│ ├── Backend Development
│ ├── Frontend Development
│ └── DevOps
├── Product
│ ├── Roadmap
│ └── User Research
└── Marketing
├── Content
└── Campaigns
```
### By Client
```
Workspace
├── Internal
│ ├── Operations
│ └── Team Development
├── Client: Acme Corp
│ ├── Website Redesign
│ └── Mobile App
└── Client: Beta Inc
└── Consulting Project
```
### By Initiative/Quarter
```
Workspace
├── Q1 2024
│ ├── Product Launch
│ └── Marketing Push
├── Q2 2024
│ └── Feature Development
└── Ongoing
├── Customer Support
└── Maintenance
```
## Best Practices
Areas should be high-level categories. Projects should be specific initiatives or ongoing work streams.
Establish naming conventions so everyone can find things easily. Document your conventions for new team members.
Don't delete completed projects—archive them. You may need to reference them later.
As your team grows, review your structure. What made sense for 5 people may not work for 50.
Keep your most-used projects in quick access to reduce navigation time.
## Troubleshooting
* Check if it was archived (view archived items)
* Use search (`Cmd/Ctrl + K`)
* Check if you have access to the area
* Verify you have permission to create projects
* Check if the area is archived
* Contact your workspace admin
* Each prefix must be unique within a workspace
* Choose a different prefix
* Consider adding numbers (MKT1, MKT2)
## Next Steps
Dive deeper into project configuration.
Add team members to your projects.
# Creating Workspaces
Source: https://docs.trilo.chat/workspaces/creating-workspaces
Set up your team's home base in Trilo
A workspace is your team's central hub in Trilo. It contains all your projects, resources, and team members. Most teams have one workspace, but you can create multiple for different organizations or purposes.
## What is a Workspace?
A workspace is the top-level container in Trilo that holds:
* **Areas**: High-level organizational categories
* **Projects**: Where your actual work happens
* **Members**: Everyone who has access
* **Settings**: Configuration for the entire workspace
## Creating Your First Workspace
### During Sign Up
When you sign up for Trilo:
Sign up with email or Google.
Enter a name that represents your team or organization.
Choose a unique URL for your workspace (e.g., `acme` for `acme.trilo.chat`).
Add a logo and invite initial team members (optional).
### Creating Additional Workspaces
If you need another workspace:
Click your workspace name in the sidebar.
Select **Create new workspace** from the menu.
Enter name, URL, and settings for the new workspace.
Your new workspace is ready to use.
## Workspace Settings
### Basic Information
| Setting | Description |
| --------------- | ------------------------------------------- |
| **Name** | Your workspace's display name |
| **URL** | The unique identifier in your workspace URL |
| **Logo** | Visual branding for your workspace |
| **Description** | Optional description of the workspace |
### Configuring Settings
Click **Settings** in the sidebar.
Navigate to **Workspace Settings** or **General**.
Update any settings you need to change.
Click Save to apply changes.
### Changing Workspace Name
1. Go to **Settings > Workspace**
2. Edit the **Name** field
3. Save changes
The new name appears everywhere immediately.
### Changing Workspace URL
Changing your workspace URL will break existing links. Share the new URL with your team after changing.
1. Go to **Settings > Workspace**
2. Edit the **URL** field
3. Ensure the new URL is available
4. Save changes
### Adding a Logo
Brand your workspace with a logo:
1. Go to **Settings > Workspace**
2. Click on the logo area
3. Upload an image (recommended: square, at least 200x200 pixels)
4. Save changes
The logo appears in:
* Sidebar header
* Workspace switcher
* Email notifications
## When to Create Multiple Workspaces
### One Workspace (Most Common)
Most teams should use **one workspace**:
* Single team or organization
* Unified communication
* Easier member management
* Consistent settings
### Multiple Workspaces
Consider separate workspaces for:
* **Different organizations**: Completely separate businesses
* **Clients**: Agency managing different client accounts
* **Personal vs. work**: Keep personal projects separate
* **Different departments**: When complete separation is needed
Areas and projects within a single workspace usually provide enough organization without needing multiple workspaces.
## Switching Between Workspaces
If you belong to multiple workspaces:
Find the workspace name in the top of the sidebar.
See a list of all workspaces you belong to.
Click on the workspace you want to switch to.
### Quick Switch
Use keyboard shortcut `Cmd/Ctrl + K` and type the workspace name to switch quickly.
## Workspace Members
### Adding Members
Invite team members to your workspace:
1. Go to **Settings > Members**
2. Click **Invite**
3. Enter email addresses
4. Select role (Admin, Member, Guest)
5. Send invitations
### Member Roles
| Role | Capabilities |
| ---------- | ---------------------------------------------- |
| **Owner** | Full control, including billing and deletion |
| **Admin** | Manage members, settings, and all content |
| **Member** | Create and edit content in accessible projects |
| **Guest** | Limited access to specific projects |
Learn more about roles and permissions.
## Workspace Limits
### Free Plan
* Limited members
* Core features available
* Basic storage
### Paid Plans
* More members
* Advanced features
* More storage
* Priority support
Check **Settings > Billing** for current plan details and upgrade options.
## Archiving a Workspace
If you no longer need a workspace but want to preserve its data:
1. Go to **Settings > Workspace**
2. Find **Archive workspace**
3. Confirm the action
Archived workspaces:
* Are hidden from the workspace list
* Preserve all data
* Can be restored later
* Don't count toward limits
## Deleting a Workspace
Deleting a workspace is permanent and cannot be undone. All data, projects, and resources will be lost.
To delete a workspace:
1. Go to **Settings > Workspace**
2. Scroll to **Danger Zone**
3. Click **Delete workspace**
4. Confirm by typing the workspace name
5. Complete deletion
Only workspace owners can delete workspaces.
## Best Practices
Pick a name that's easily recognizable. Usually your company or team name works well.
Your workspace URL appears in shared links. Choose something clean and professional.
A logo makes your workspace more recognizable and feels more professional.
Don't create multiple workspaces unless you have a specific need. Start simple and add complexity later.
## Next Steps
Learn how to organize within your workspace.
Add your team to the workspace.
# Project Settings
Source: https://docs.trilo.chat/workspaces/project-settings
Configure your projects for optimal team collaboration
Each project in Trilo has settings that control its behavior, access, and features. This guide covers all project settings and how to configure them.
## Accessing Project Settings
Navigate to the project you want to configure.
Click the gear icon or **Settings** in the project navigation.
Adjust settings as needed.
## General Settings
### Project Name
The display name for your project:
* Shown in sidebar and navigation
* Used in notifications and emails
* Can be changed anytime
**Tips for good names:**
* Keep it concise but descriptive
* Include client name for client projects
* Use consistent naming conventions
### Project Description
An optional description that helps team members understand:
* What the project is about
* Its goals and objectives
* Any relevant context
Good descriptions include:
* Purpose of the project
* Key stakeholders
* Timeline or deadlines (if applicable)
* Links to relevant resources
### Project Prefix
The short code used for task IDs:
| Setting | Example |
| -------------- | ----------------------------- |
| Prefix: `PROD` | Tasks: PROD-1, PROD-2, PROD-3 |
| Prefix: `MKT` | Tasks: MKT-1, MKT-2, MKT-3 |
**Rules:**
* 2-4 characters recommended
* Letters and numbers only
* Must be unique in the workspace
* Cannot be changed after tasks are created (without affecting existing IDs)
### Area Assignment
Which area the project belongs to:
1. Click the **Area** dropdown
2. Select the target area
3. Save changes
Moving projects between areas doesn't affect project data.
## Status Settings
### Project Status
Track the overall state of your project:
| Status | Meaning |
| ------------- | ---------------------------------- |
| **Active** | Currently in progress |
| **Completed** | Finished but not archived |
| **On Hold** | Paused temporarily |
| **Archived** | No longer active, hidden from view |
### Due Date
Set a target completion date:
* Appears on the project overview
* Can trigger reminders
* Helps with planning and prioritization
## Feature Settings
### AI Features
Control whether AI coworkers can assist in this project:
* **Enabled**: AI coworkers can be assigned tasks, participate in chat
* **Disabled**: AI features are turned off for this project
Disabling AI features might be appropriate for sensitive projects where AI interaction isn't desired.
### Feature Toggles
Some features can be enabled or disabled per project:
| Feature | Description |
| ------------- | ----------------------- |
| **Tasks** | Task management |
| **Resources** | Knowledge base |
| **Chat** | Project channel |
| **Calendar** | Project-specific events |
Most projects use all features, but you can disable unused ones to simplify the interface.
## Member Settings
### Project Members
Control who has access to the project:
**Adding members:**
1. Go to project settings > Members
2. Click **Add member**
3. Select workspace members
4. Choose their project role
**Removing members:**
1. Find the member in the list
2. Click **Remove** or the X icon
3. Confirm removal
### Project Roles
Project-specific roles determine what members can do:
| Role | Capabilities |
| ----------------- | ---------------------------------------------- |
| **Project Admin** | Full control over project settings and content |
| **Editor** | Create and edit all content |
| **Viewer** | View content but cannot edit |
### Default Access
Configure default access for new workspace members:
* **Automatic access**: New members get access automatically
* **Manual only**: Must be explicitly added
## Notification Settings
### Project Notifications
Configure notifications for project activity:
| Event | Notification Options |
| -------------------- | ---------------------------------- |
| **New tasks** | All members, assignees only, none |
| **Task updates** | All members, related members, none |
| **New messages** | All, mentions only, none |
| **Resource changes** | All, editors only, none |
### Personal Override
Individual members can override project notification settings in their personal preferences.
## Danger Zone
### Archiving the Project
Archive projects that are complete or no longer active:
Open the settings page.
Scroll to the Danger Zone or Archive section.
Confirm the action.
**Archived projects:**
* Hidden from normal navigation
* All data preserved
* Can be restored anytime
* Don't count toward limits
### Restoring Archived Projects
1. View archived projects (filter or settings)
2. Find the project
3. Click **Restore**
4. Project returns to active state
### Deleting the Project
Deletion is permanent. All tasks, resources, chat history, and settings will be lost forever.
Find the delete option in settings.
Start the deletion process.
Type the project name to confirm.
The project and all its data are removed.
## Integration Settings
### Connected Services
If your workspace has integrations, projects may have specific settings:
* **Calendar sync**: Which calendars sync with this project
* **Notifications**: Where project notifications go
* **Automations**: Project-specific automation rules
### Webhooks
For advanced integrations, configure webhooks:
1. Go to project settings > Integrations
2. Add webhook endpoints
3. Select events to trigger webhooks
4. Save configuration
## Best Practices
When creating a new project, take time to configure all settings properly. It's easier than fixing them later.
A good project description saves time explaining the project to new team members.
Pick a prefix you can live with long-term. Changing it later affects task ID continuity.
Periodically check who has access to projects. Remove members who no longer need access.
When in doubt, archive rather than delete. You can always delete later, but you can't recover deleted projects.
## Settings Reference
### Quick Reference Table
| Setting | Location | Who Can Change |
| -------------- | ------------- | --------------------------------------- |
| Name | General | Project Admin |
| Description | General | Project Admin |
| Prefix | General | Project Admin |
| Area | General | Project Admin |
| Status | General | Project Admin |
| Due Date | General | Project Admin |
| Members | Members | Project Admin |
| AI Features | Features | Project Admin |
| Notifications | Notifications | Project Admin (default), All (personal) |
| Archive/Delete | Danger Zone | Project Admin |
## Troubleshooting
* Verify you're a Project Admin
* Check if the project is archived
* Contact your workspace admin for permissions
* Check project notification settings
* Verify individual member notification preferences
* Ensure they have proper access to the project
* Enable "Show archived" in view filters
* Search by project name
* Check if it was deleted instead of archived
## Next Steps
Add team members to your project.
Understand access control in detail.