01
Get started
ActVox basics
A workspace is the unit where ActVox keeps your company context and work. Use one workspace for one brand, client, or operating team so the agent can reason from the right business context.
Your workspace can contain:
| Object | Use it for |
|---|---|
| Pages | Plans, briefs, notes, meeting records, operating documents, and structured evidence. |
| Databases | Reusable tables, boards, calendars, and lists for campaigns, tasks, content pipelines, competitors, or research. |
| Context | Your business profile, standing instructions, strategy, reports, sources, uploads, and memory. |
| Conversations | Work with the agent while preserving the workspace context. |
| Outputs | Content and agent-generated artifacts that can be reviewed and reused. |
First workspace setup
- Sign in. A new workspace opens on three doors: Connect my AI, Analyze my website, or Start blank.
- Connect my AI copies a prompt into Claude, Codex, ChatGPT, or another client. Read and write are the powers it asks for. What it writes shows up here as pages you can open.
- Analyze my website runs an analysis. Start blank opens the workspace so you can write the first page yourself.
- Home then shows Get started, which says what to do next. When it reads You're set up, that heading opens Start here.
- Add source material in Knowledge base. Files in Files & Media are not searched until you add them there.
- Open ACTVOX.md for standing instructions the agent should consider on every turn: approval boundaries, terminology, voice, target geography, or source-quality rules.
A teammate invited into an existing workspace still confirms the company profile before the workspace opens. Company website, description, audience, and products stay editable in Settings.
Start here
Start here is a normal page under Home. It says how the workspace fits together, in five blocks: Connect your AI, Organize your workspace, Your sidebar, Knowledge Base and Memory, and Studio. Each block is about five lines and one Try it, which opens the real place. Notes you type between the blocks stay on the page. The title follows your language until you rename it. The page is not shared.
Open it from the account menu (Open the Start here guide) or from the command palette. If it was in Trash, that opens the same page again.
The first time you open Memory, Files & Media, Reports, Content, Calendar, or Brand DNA, a one-line strip explains the area, offers its main action, and links How it works to the matching Start here section. Knowledge Base, Artifacts, and pages get a short tour instead, pointing at the real controls. Each shows once. ActVox starts at most one of these, or any other tip, on its own every six hours, and none in your first day or while Get started is on Home. Take the tour in the account menu walks the screen you are on whenever you ask for it.
Good operating pattern: establish the business profile and source material before asking for a consequential strategy, report, or content plan. Better context produces more useful and more attributable output.
Sidebar navigation
The left sidebar is the map.
| Row | What you will find |
|---|---|
| New | A chat, a page, a database, or a whiteboard. |
| Home | The workspace home page, and the pages filed under it, including Start here. |
| Page tree | Pages and databases nested together. The row is labelled with the workspace name. Drag one page onto another, and pin what you use most. |
| Tools | Reports, Content, Knowledge Base, Strategy, Artifacts, Files & Media, Memory, Calendar, and Brand DNA. The ones you use most sit at the top. The rest wait under More. |
| Pinned | Your private shortcuts. |
Content, Calendar, and Brand DNA are the Studio tools: drafts, when each draft goes out, and the colours, type, logo, and voice every image and draft follows.
Skills and Connectors are not a sidebar root. Skills open from the chat composer’s ✨ menu. Connectors open from Connect your AI and from the Skills and Connectors tab.
02
Workspace OS
The Workspace OS is the main work surface. It keeps live documents, structured work, context, and agent output connected to the same workspace.
Get started on Home says what to do next. Start here, a page under Home, says how the pieces fit. Open it from the account menu or the command palette.
Workspace settings
Open Settings from the workspace controls to maintain the workspace identity and marketing profile.
| Setting | Why it matters |
|---|---|
| Workspace/project name | Identifies the workspace in navigation and switching. |
| Business name and logo | Gives the workspace a clear company identity. |
| Website URL | A starting point for company analysis and source context. Use a complete https:// or http:// URL. |
| Location and industry | Helps ground local, market, and audience work. |
| Business description | A concise explanation of what the company does. |
| Brand voice and target audience | Improves content, messaging, and strategic recommendations. |
| Key products and unique selling points | Gives the agent durable commercial context. |
| Brand colors | Supports brand-aware work and media direction. |
| Language | Sets the workspace interface language. |
Click Save after changing settings. Treat the destructive Delete workspace control carefully: it requires typing the workspace name to confirm.
Settings and preferences
The workspace provides several settings areas. Availability may vary by your account and deployment.
| Settings area | Use it for |
|---|---|
| General | Workspace identity, business profile, language, and destructive workspace controls. |
| Agent | Agent name, response language, greeting, and communication style. |
| Customize | Adjust sidebar layout, Recent items, and workspace profile details. |
| API keys | Create, inspect, revoke, or delete access keys. |
| Analytics | Review workspace usage and performance data when available. |
| Shared links | Audit and revoke live public or organization-only page/database links. |
| Billing / Auto-adapt / Engineering | Advanced workspace controls when enabled for your plan or deployment. |
Agent preferences
In Settings → Agent, you can set the agent name, default response language, greeting, and communication style. Available built-in personas include Professional, Friendly, Concise, Detailed, and Custom.
For standing instructions, use ACTVOX.md in the Context section of the workspace tree. It is the current editable instruction surface that the agent reads on every turn. The older system-instructions settings field is retained for legacy setup but is not the place to maintain live instructions.
Workspace navigation
Use tabs to work across multiple pages, databases, conversations, and outputs without losing your place. The active tab appears in the center workspace area. Open related work in separate tabs when comparing a brief to a database, report, or agent result.
Useful navigation habits:
- Keep business-wide guidance in ACTVOX.md, Profile, and Strategy, not scattered across campaign pages.
- Keep the working system - planning, execution, and tracking - under Workspace.
- Put raw evidence in Knowledge base or Files & Media, then cite or link it from pages.
- Use Content and Artifacts as output review queues rather than as the only source of truth.
03
Create and format pages
Pages are durable documents for briefs, research notes, plans, reports, playbooks, and decisions.
Create a page
You can create pages from the Workspace tree or from inside another page.
- In Workspace, use the add control for the target location.
- Choose Page and give it a clear, action-oriented title.
- To create a nested page, open the parent page and insert a Page block, or create it in the corresponding subtree.
- Start writing. Changes save automatically after a short pause.
A useful naming convention is: YYYY-MM - outcome - audience or channel, for example 2026-08 - LinkedIn founder narrative - B2B SaaS.
Use blocks and slash commands
Type / in the page editor to open the block menu. Search by name, then select a block. You can also use the block handle to insert, move, or change a block.
| Block group | Examples |
|---|---|
| Basic | Text, headings 1-4, bulleted and numbered lists, to-do lists, toggles, callouts, quotes, simple tables, dividers, child pages, and page links. |
| Media | Images, video, audio, files, web bookmarks, and code blocks. |
| Database | Inline database, full-page database, linked database view, and table, board, gallery, list, or calendar views. |
| Advanced | Table of contents, equations, breadcrumbs, and two- to five-column layouts. |
| Embeds | URL embeds and sandboxed HTML where enabled. |
Format and organize pages
- Use headings for a scannable hierarchy; table of contents blocks use that hierarchy.
- Use a callout for the decision, assumption, risk, or owner that a reader must not miss.
- Use to-do blocks only for lightweight page-local work. Use a database when work needs owners, dates, reporting, or repeatability.
- Add a page icon or cover to distinguish high-traffic documents.
- Link related pages rather than copying their content. This keeps evidence and decisions current.
- Use the comments panel for collaboration and the version/history controls for review when available.
- On a phone, you can comment while staying in Reader. Select text and choose Add comment to discuss that passage. Editing permission is required.
- When an agent suggests changes on a phone, choose Review to enter Edit and jump to the first change. Accept all applies the pending changes; Reject all dismisses the suggestion. Editing permission is required.
- To change block order on a phone, enter Edit and choose Reorder. Use the up/down buttons to move a block; each move has its own undo step. Close the sheet or use Back to return to the page. Reordering is unavailable while an agent suggestion is pending.
Add attachments and media
Insert an Image, Video, Audio, or File block, then choose the file to upload. You can also add page attachments. Use descriptive titles and surrounding explanatory text so another teammate - and the agent - understands why the material matters.
3D models
Insert a 3D model block and choose a GLB or glTF file (up to 50 MB). The block shows the model in an orbit-and-zoom viewer with the file name, size and format in the corner. Everything about the block can be changed in place:
Settings(the gear in the frame) opens a details table inside the same frame: alt text, a caption shown under the model, auto-rotate, camera controls and height.Savewrites all of it at once;Canceldiscards it. The viewer previews the draft while you edit.MoreoffersReplace model,Set AR file(a USDZ companion so iPhone and iPad can open the model in AR),Poster from current vieworUpload poster…(the still used for PDF export and print),Remove poster,DownloadandCopy link to block.Open in new tabshows the model on its own page;Fullscreenenlarges it in place.
A USDZ is an AR companion, not a model: add the GLB or glTF first, then set the AR file. Replacing the model clears the poster and the AR file, because both pictured the old file. Shared pages and exports keep the caption and camera settings.
04
Build databases
Databases make recurring work structured, filterable, and reviewable. Typical examples include content calendars, campaign trackers, research libraries, CRM-style lists, competitor trackers, and task boards.
Create a database
- In Workspace, choose the add control and select Database.
- Choose whether to create a full-page database or insert one inside a page.
- Name the database for the operating job, not the tool - for example,
Q3 Content Pipelinerather thanContent table. - Create the first properties and views before importing a large amount of data.
Build a useful schema
Every database has rows, which open as full pages, plus properties that describe each row.
Start small. For a content pipeline, use:
| Property | Recommended type | Example |
|---|---|---|
| Name | Title | AEO: stop optimizing only for rankings |
| Status | Status or select | Idea, Draft, In review, Scheduled, Published |
| Channel | Multi-select | LinkedIn, Blog, Newsletter |
| Owner | Person | Content lead |
| Publish date | Date | 2026-08-13 |
| Strategic theme | Relation or select | Category education |
| Source / evidence | URL, relation, or text | Research report link |
Available property types can include text, number, select and status, date, person, relation, URL, phone, email, formula, and system fields such as created time, last edited time, created by, last edited by, and ID.
Choose the right view
| View | Best for |
|---|---|
| Table | Data entry, audits, research inventories, and detailed comparison. |
| Board | Workflows grouped by status or another select property. Drag cards between groups to update progress where supported. |
| Calendar | Publishing schedules, launches, events, and deadline-driven work. |
| Gallery | Visual assets, creative concepts, and card-based libraries. |
Use filters to hide irrelevant rows, sorting to create a decision-ready order, and group-by to make workflow states visible. A database’s shared link respects its saved view configuration, including filtering and order.
Work in a table
- Hover a row to see its controls on the left: + adds a row below it (hold Alt to add it above), the grip moves the row when you drag it and opens the row menu when you click it, and the checkbox selects the row.
- Choose Open in a row's name to read and edit the row as a page. In a full-page database the row opens beside the table, and the table stays editable; View settings → Open pages in switches between Side peek, Center peek and Full page.
- Click a column's header for everything about that column: filter, sort, calculate, freeze the columns up to it, wrap its text, hide it, change its type or edit its options.
- The line under the table shows one calculation per column, such as a sum or a count, and keeps it with your view.
- Choose Search in the view bar to show only the rows that contain every word you type.
- Select several rows to change them together: the bar above the table sets a property on all of them, duplicates them or deletes them. Shift-click selects a range; Escape clears the selection.
Linked and inline databases
- Use an inline database to keep a small working table inside a planning page.
- Use a full-page database for a team operating system that needs many views.
- Use a linked database view to show the same source database in a different page and context. For example, show only LinkedIn drafts on a channel plan page without duplicating the underlying items.
06
Work with the agent
The ActVox agent works from workspace context, attached material, relevant pages, and supported integrations. It is designed to create durable results - pages, plans, drafts, records, and artifacts - rather than only returning disposable chat prose.
Ask good questions
Use a clear outcome, relevant context, and a boundary. For example:
Review the competitor notes in this workspace, create a one-page positioning recommendation, and do not change our existing strategy page.
You can reference pages, files, and workspace objects in a conversation. Keep source material current so the agent can ground its output.
Attach files to a conversation
Use the attachment control in the composer to add authorized source material to the current request. ActVox uploads the file to durable workspace storage before it sends the message. While an upload is in progress, Send and the Enter shortcut remain disabled. Wait until the attachment appears in the composer; if the upload fails, resolve the visible error and attach the file again.
The agent can extract bounded text from PDF, DOCX, TXT, Markdown, CSV, JSON, XML, HTML, and other text-based files. Images, audio, and supported video use their media-processing paths. A successfully attached file keeps a persistent serving URL in the conversation, so the message and attachment remain available after reload. Extraction still depends on a readable file: scanned PDFs without text, encrypted documents, corrupt files, and unsupported binary formats may require another format or explicit context in the prompt.
Tell the agent what the file is and what to do with it. For example:
Read the attached customer interview notes, identify recurring objections, and create a cited summary page. Do not infer facts that are not present in the document.
Do not attach credentials, secrets, or material you are not authorized to process.
Plan
Use Plan for work that is multi-step, ambiguous, cross-functional, or consequential.
A plan should make the proposed work inspectable before execution. It can include scope, evidence to use, assumptions, steps, expected outputs, risks, and approval points. Plan is appropriate for requests such as:
- Create a 90-day content strategy from research and the current brand profile.
- Audit competitor positioning and recommend a category narrative.
- Design a research and reporting workflow before changing a database.
Review the plan, correct assumptions, and approve the next step in the conversation. Do not treat a plan as proof that an action has been completed.
Act
Use Act when you want the agent to execute a supported operation. Act can create or update supported workspace objects, organize material, produce reports, generate drafts, and run eligible analysis flows.
ActVox verifies required effects before it claims success. For example, when asked to create a page or content draft, the expected result is a real workspace object you can open and edit - not only a pasted response in the conversation.
Low-risk, reversible workspace writes may run directly when your request is explicit. Destructive, bulk, publishing, live-document, or otherwise high-impact actions can require review or approval. External availability also depends on integration permissions and product policy.
Skills
Skills are reusable, versioned instruction packages available in a workspace. Access them from the chat composer’s ✨ menu or through their associated slash commands when available.
Use a skill when the task benefits from a repeatable procedure, such as onboarding context capture, creating a company profile, or producing an initial content draft.
Good practice:
- Read the skill description and expected output.
- Confirm it matches the workspace and intended outcome.
- Run it with the specific information it needs.
- Review the generated page, draft, or artifact before sharing or publishing.
Skills do not bypass workspace permissions, action allowlists, or approval requirements. User-authored skills are versioned and should not be silently rewritten by autonomous improvement workflows.
07
Automation and connections
ActVox can connect supported sources, platforms, and agent tooling to a workspace. Connections are scoped to the workspace and subject to the connected provider’s permissions, availability, quotas, and policy.
Connect your AI
Open Connectors in the sidebar and choose Connect your AI.
- Pick the AI you use. Some run in your browser (Claude, ChatGPT); others run in your terminal (Claude Code, Codex).
- For a terminal client, copy the prompt it shows and paste it into the client. It sets up the connection itself and opens an ActVox window. For a browser client, add ActVox to it as the steps show.
- In the ActVox window, choose this workspace and click Allow access. Read and write are chosen for you; Choose permissions changes them.
- The flow says the AI is connected. Copy the first task it offers and paste it into the AI. It asks you a few questions, then saves its plan here as a page, and Open it takes you there.
Each connected AI has its own Settings: rename it, turn on Mentions and tasks so it can be @mentioned and assigned work, and choose who can use it.
Availability vocabulary
The UI uses these exact availability states: supported, canary_passed, verified, verified_read, documented, unavailable and blocked. verified and verified_read are permanent approvals based on real production connections: verified means a write was confirmed in production, verified_read means reads only. A label says how far ActVox has verified a client end to end. It is not the access level: a connection's permissions are what you approve at consent. The state is documented separately for each product: MCP grants authenticated tools and workspace data; a skill supplies instructions for a local agent.
AI-agent availability
| AI agent | MCP | Skill |
|---|---|---|
| ChatGPT | verified | — |
| Claude (hosted) | verified | — |
| Claude Code | verified read | supported |
| Codex | verified (through ChatGPT’s connector) | supported |
| Hermes | verified through the ActVox CLI | supported |
| Grok | verified | — |
| OpenClaw | verified through the ActVox CLI | No catalog skill or installer |
Setup steps for each agent are on the Agents page.
Keep the three stores separate
Profile, workspace instructions, and the Knowledge Base are three separate stores. A connection does not merge them into one memory blob.
- Profile stores the business portrait and identity fields.
- Instructions store how the agent should work with you.
- The Knowledge Base stores sources such as sites and documents; indexing can spend credits.
ChatGPT — MCP — verified
- Add ActVox as a custom connection in ChatGPT Developer mode, then authorize the hosted MCP endpoint
https://api.actvox.com/mcpwith OAuth. - Start with read access for one workspace. ChatGPT has no ActVox skill installer; use the Codex tile for a local skill.
Claude (hosted) — MCP — verified
- In Claude, open Customize → Connectors →
Add custom connector, pastehttps://api.actvox.com/mcp, and chooseSign in nowwith Claude’s published OAuth identity. - Team and Enterprise owners can add the connector once in organization settings, but each member still signs in and consents individually. Claude Code is a separate tile.
- Approved permanently on 2026-10-03 from production use: live connections wrote and the result was confirmed by read-back, so its setup panel reads Integration: Tested.
Claude Code — MCP verified_read; skill supported
- The hosted MCP path is approved permanently at verified read: live Claude Code connections read workspace data in production, and no write through its own connection has been confirmed yet. Run
claude mcp add --transport http actvox https://api.actvox.com/mcp, thenclaude mcp login actvoxand complete consent. - The installable skill is supported for the
claudetarget. Use the Claude Code tile for the installer, key setup, and local verification.
Codex — skill supported; MCP verified
- The installable skill is supported for the
codextarget. Use the Codex tile to install it, issue a workspace key, and run the read-only doctor and capabilities checks. - Hosted MCP is approved permanently: Codex’s production use runs through ChatGPT’s connector and includes writes confirmed by read-back. To connect the Codex CLI with its own identity, run
codex mcp add actvox --url https://api.actvox.com/mcp, thencodex mcp login actvoxand complete consent. A local skill install is not hosted MCP support.
Hermes — skill supported; verified through the ActVox CLI
- The installable skill is supported for the
hermestarget. Use its tile for the skill installer and workspace-key setup. - Hermes works with ActVox through the skill and the ActVox CLI (a workspace key or a CLI login). That path is approved permanently on production writes, and its setup panel reads Integration: Tested over the ActVox CLI; the tile itself reads Connected once you connect one here.
- Hermes’ own hosted MCP connection stays available: run
hermes mcp add actvox --url https://api.actvox.com/mcp --auth oauth, thenhermes mcp login actvoxand complete consent. The skill’s instructions do not grant workspace data by themselves; keep the key in the agent’s protected environment.
Grok — MCP — verified
- In grok.com, open Connectors → New Connector → Custom and add
https://api.actvox.com/mcpwith the OAuth values shown on the Grok tile. - Grok has no ActVox CLI or skill installer. The hosted connection is approved permanently: live Grok connections wrote in production and the result was confirmed by read-back.
OpenClaw — verified through the ActVox CLI; no installer
- OpenClaw works with ActVox through the ActVox CLI (the ActVox CLI tile: a CLI login or a workspace key). That path is approved permanently on production writes, and its setup panel reads Integration: Tested over the ActVox CLI; the tile itself reads Connected once you connect one here.
- Its own hosted MCP connection stays available: run
openclaw mcp add actvox --url https://api.actvox.com/mcp --transport streamable-http --auth oauth, thenopenclaw mcp login actvoxand complete consent. There is no catalog skill or installer target for it. - The manifest still lists
local_skillas a limitation, but OpenClaw has no catalogskill: trueflag and is not an installable skill client. Do not claim it is supported or add an installer.
Short first test
After a supported skill or an available MCP connection is ready, send this read-only Knowledge Base smoke test:
Run a read-only Knowledge Base smoke test. Tell me which workspace you can access and list the titles of the first three Knowledge Base sources. Do not write or save any personal information unless I explicitly confirm the exact fields and values first.
This is a smoke test, not the five-step onboarding. If onboarding follows, ask before each write and read back the profile, instructions, and Knowledge Base changes separately.
Manage and remove
- For MCP, the Connectors page shows the grant, last call, and verified effect; pause, resume, or revoke access there, then remove the connection in the provider.
- For a skill, revoke its workspace key on the Connectors page and remove the installed skill from the local agent.
- If a consent page says the client is not approved, the current tile policy is authoritative. Retrying does not change a documented, unavailable, or blocked state.
Your agents and your role
- Anyone with the editor role or above can connect their own agent, through a consent page or with a key on a connector tab. You name the agent when you connect it. It is private to you until an owner or admin shares it with the workspace, and only you see its connections.
- An agent never does more than the person who connected it can do now. An editor's agent cannot share, publish or change workspace settings; if you become a viewer, your agent can only read; if you leave the workspace, it stops working.
- On Free, AI connectors count for the whole organization: a product another member already connected adds no new connector.
Automation boundaries
An available connection does not mean every action is automatic or approved. Publishing, paid activity, destructive updates, and high-impact external actions can require explicit approval. ActVox does not guarantee external platform availability or campaign outcomes.
08
Admin and security
Workspace and organization administration
Workspace access follows the authenticated user and workspace or organization boundary. In an organization, administrators can manage organization membership, invitations, and roles through the organization controls.
Use the least authority necessary:
- Give members access only to the workspace and information they need.
- Restrict administrative roles to people who manage membership, settings, or high-impact actions.
- Review organization invitations and member roles regularly.
- Remove access promptly when a contractor, client engagement, or employment relationship ends.
API keys
Open Settings → API keys to create and manage API keys.
| Permission | Access |
|---|---|
workspace:read | Read project data. |
workspace:write | Modify project data. |
strategy:read / strategy:write | Read or modify project strategy. |
content:read / content:write | Read or create and modify content. |
reports:read | Read reports. |
admin | Full access. Use sparingly. |
Prefer a project-scoped key over a multi-project key whenever possible. The secret value is shown only when created. Store it in a proper secret manager or the approved tool environment, not in a page, chat, uploaded file, screenshot, or source code repository.
Revoke a key immediately if it may have been exposed, is no longer needed, or belongs to a departing collaborator. You can also delete a revoked key to remove it from the list.
Account and sharing security
- Open Manage account from the account menu: Account (name, email addresses, connected accounts), Security (password, passkeys, active devices, delete account), Credits (your ActVox Credits), and Billing (payment methods and statements). Organization admins open Manage organization from the gear on an organization row: General (name, logo, leave, delete), Members (invitations and roles), Credits (shared wallet and seats), and Billing.
- Use the account security controls for your personal account security settings.
- Use Settings → Shared links to audit what is externally accessible right now.
- Treat public links as public. Do not rely on obscurity of the URL as a security control.
- Rotate a link by changing its audience or revoke it and create a new link.
- Use organization-only links when the material is intended only for your organization.
09
Reports
Reports are durable research and audit outputs connected to the workspace. They can capture analysis of websites, markets, competitors, SEO/AEO, social presence, local presence, and other supported business signals.
Create or run a report
- Open Reports in the Context section of the Workspace OS.
- Use Run new analysis when it is available.
- State the question, scope, sources, market, or target audience clearly.
- Review the report’s evidence, assumptions, and recommendations.
- Turn accepted recommendations into a Strategy, a page, a database item, or a task.
The standalone reports route redirects to the Workspace OS; the Workspace OS report entry is the canonical place to find and continue report work.
Review a report critically
A report is evidence-informed output, not a guarantee. Before acting on it:
- Check the source quality and date.
- Separate observed facts from hypotheses and recommendations.
- Confirm anything that affects legal claims, pricing, budgets, external commitments, or publishing.
- Link the report to the strategy or decision it informed.
10
Strategy
Strategy is the durable workspace artifact for the choices that guide execution. It should connect research to priorities, audiences, positioning, channels, campaigns, and measurement.
Use Strategy for questions such as:
- Which audience segment should we prioritize this quarter?
- What category narrative and value proposition should guide content?
- Which channels deserve investment, and what will we measure?
- What must be true before we launch a campaign?
Recommended strategy structure
- Objective - the commercial or strategic outcome.
- Audience - who matters most, their context, and the job they are trying to do.
- Evidence - reports, sources, research, and customer signals.
- Positioning - category, differentiated value, proof, and objections.
- Strategic choices - what to prioritize, avoid, sequence, or test.
- Execution system - content, campaign, research, and operating work linked to pages or databases.
- Measures - leading signals, outcome metrics, owner, review cadence, and decision rules.
Do not make Strategy a storage place for every idea. Keep it decision-oriented and link to deeper evidence elsewhere.
11
Design.md
Design.md is a Context entry for durable design direction. Use it to make creative work more consistent across people, pages, and agent-assisted output.
This guide interprets “Design my” as the Workspace OS Design.md context surface.
A strong Design.md can include:
- Brand personality and visual principles.
- Color and typography guidance.
- Image, video, illustration, and layout direction.
- Examples of what to emulate and what to avoid.
- Accessibility and localization requirements.
- Channel-specific constraints, such as LinkedIn carousel dimensions or webinar visual standards.
Use concise, testable language. For example, write “editorial, precise, high-contrast, documentary imagery; no generic AI blue gradients” instead of “make it modern.” Link approved source assets from Files & Media or Knowledge base.
12
Knowledge base
The Knowledge base is the workspace source library. Use it for materials your agents should be able to search, cite, and revisit. Uploads elsewhere are not searched until you add them here.
Add sources
You can add:
- A web page, with Add a link. ActVox reads the page and indexes it. Indexing uses ActVox Credits.
- A file that is already in Files & Media, with Add to Knowledge Base.
- A PDF or a Word document (
.docor.docx) from this page. - Discovered sources from an eligible industry, business type, and location search.
Open Knowledge Base in the sidebar. A ready source reads Ready and shows how many sections were indexed. Search the knowledge base to confirm the source is useful.
Find and use evidence
Use Knowledge base search to retrieve relevant workspace sources before writing a brief, report, strategy, or content asset. Source discovery can help identify candidates, but review discovered sources before treating them as authoritative. You can rate discovered sources to improve future discovery relevance.
Maintain quality
- Prefer primary sources, approved brand material, customer research, and dated market evidence.
- Remove stale, irrelevant, duplicate, or untrusted sources.
- Keep confidential material in the appropriate workspace and never add secrets.
- Use meaningful source titles so teammates can assess a result without opening every file.
- Re-index an updated source when the source content has materially changed.
13
Files & Media
Files & Media holds everything uploaded to the workspace: documents, images, and video.
Use Files & Media when you need to:
- Preserve the original file before turning it into a page or report.
- Give the agent an authorized attachment to reference.
- Preview, organize, rename, move, or remove workspace files.
- Retry an upload that failed.
Upload carefully
- Open Files & Media in the sidebar and use Upload, or use an upload control on the surface you are in.
- Select the file and wait for its upload state to complete.
- Rename or place it where the team will find it.
- Add it to the Knowledge base when agents should search it. An upload is not searched on its own.
Uploads are not automatically public. Sharing a page or database is a separate action.
14
Memory
Memory holds short facts about this workspace. You add them with Remember. The chat and a connected agent can add them too. Facts the chat stored appear under Remembered in chat. A fact that is only yours is marked so. Forget removes one you are allowed to remove.
Examples of useful memory:
- A priority audience, a positioning constraint, or a target region.
- An approved terminology rule or a known objection.
- A recurring operating preference that should shape future work.
Memory is workspace-scoped. Treat it as short context, not as a secret vault and not as a substitute for a page or a source.
Use memory responsibly
- Put standing operating instructions in ACTVOX.md.
- Put files and web pages agents should search in the Knowledge base. Keep the original file in Files & Media.
- Keep a decision in Strategy, a report, or a page where it can be reviewed and revised.
- Do not rely on memory alone for a critical claim. Confirm it against a current source.
15
Conversations
Conversations are the agent work surface. They live in the Agents area of the Workspace OS and keep the discussion connected to the workspace’s context and objects.
Use conversations for work, not just questions
A productive conversation usually has:
- Outcome - what you need delivered.
- Context - relevant pages, sources, files, or business constraints.
- Boundary - what the agent may and may not change, publish, or assume.
- Review point - when you want a plan, draft, recommendation, or approval request.
Example:
Plan a competitor positioning review for our UK market. Use the knowledge-base sources and the current strategy. Create a page with evidence and recommendations, but do not alter Strategy until I approve it.
Manage conversation output
When a conversation produces something worth keeping, ask the agent to save it as a page, report, strategy update, content draft, database item, or artifact. Open the resulting object and review it outside the chat. This creates a durable record and makes the work reusable by the team.
Use attached files, referenced pages, and skills deliberately. They improve grounding but do not remove the need for human review.
16
Studio
Studio is where marketing work is made. It is four tools: Content, Calendar, and Brand DNA in the sidebar, and the Media studio inside a draft. A draft is a post for one channel, with its images or video.
Content
Content is the output area for marketing assets such as drafts, adaptations, and media-oriented work. It is designed to connect content back to workspace strategy, research, and source context.
Use Content to:
- Create and review draft marketing assets.
- Organize variants and adaptations.
- Link content to the relevant audience, campaign, channel, strategic theme, and evidence.
- Prepare work for a content calendar or publishing workflow.
Content workflow
- Start with a strategic intent and a specific audience.
- Give the agent approved sources, positioning, and channel constraints.
- Ask for an editable draft - not automatic publication.
- Review factual claims, voice, differentiation, CTA, and compliance.
- Save the approved draft in Content and connect it to a campaign or database record.
- Use the relevant integration or publishing process only after the required approval.
Draft, adapt, and schedule a post
The fastest path from an idea to a scheduled post runs through the agent and a calendar database.
- Ask the agent for a draft and name the platform, the audience, and the goal.
- Ask for adaptations of the approved angle for the other platforms you use.
- Review each draft in Content and edit the claims, voice, and call to action.
- Set the status to Scheduled and pick the publish date on the linked calendar record.
- Publish through the connected account only after the required approval.
Example request: "Draft a launch post for Instagram for local cafe owners, then adapt it for LinkedIn and X, and put both on next week's calendar."
ActVox can generate and adapt content, but it does not guarantee reach, rankings, engagement, conversions, or revenue.
Calendar
Open Calendar to see when each draft goes out. New content there starts a draft. Approved posts publish to Instagram or LinkedIn once that account is connected.
Brand DNA
Brand DNA is the colours, type, logo, and voice that every image and draft follows. Open it in the sidebar. Scan my brand reads a website or a supported social profile and fills those fields. Reference sites are a separate list: they steer composition and do not change the palette or the logo.
Media studio
Open a draft to edit its images, a carousel, or video. Image, Carousel, and Video are modes of that one editor. Generated images and video also appear in Files & Media.
17
Artifacts
Artifacts are generated workspace outputs that are not simply a page or content draft. They can include results from supported agent or media-generation workflows and retain the context needed to inspect or reuse the work.
Use Artifacts to:
- Review a generated deliverable before deciding where it belongs.
- Keep output provenance connected to the workspace.
- Promote a usable output into Content, a page, a report, or another operating record.
- Separate experimental or generated material from final approved source-of-truth documents.
Review before reuse
Before sharing, publishing, or relying on an artifact:
- Open it and inspect the actual result.
- Check that it matches the requested audience, brand, source, and channel constraints.
- Verify factual assertions against the original evidence.
- Confirm rights, permissions, and platform requirements for any external use.
- Move or link the approved result into the page, database, Content item, or campaign where the team will operate from it.
Operating principles
- Context first. Keep the business profile, instructions, evidence, and strategy current.
- Pages for thinking, databases for repeatable operations. Do not turn every page into a table or every table into a document.
- Plan before consequential work. Review scope and assumptions before execution.
- Act with review. Inspect created objects and approve high-impact external activity explicitly.
- Preserve evidence. Link recommendations to reports, sources, and decisions.
- Share narrowly. Prefer the smallest audience and the smallest object that solves the collaboration need.
- Protect secrets. Do not place credentials, tokens, or sensitive personal data in public links, pages, prompts, or uploaded files.