← Docs

Using the portal

The portal (app.keikaku.ai) is where you run the whole system: create projects, set goals, watch agents work, ask questions, and manage your team. This guide walks through everything, feature by feature. Every action here can also be scripted over the API or driven by an AI over MCP.

Projects & the workspace

A project is one repository's worth of work. Open a project from the dashboard to enter its workspace — a left sidebar with two groups:

• Work — Outcomes, Tasks, Queries, Pull requests, Questions.
• Configuration — Agents, Secrets, Design, Members, Settings.

Counts and badges on each item tell you at a glance how much is there (e.g. active tasks) and what needs attention (e.g. open questions, pending queries). The URL carries the section (/projects/<id>/tasks) so any view is deep-linkable.

Outcomes: priority & tags

An outcome is a high-level goal that tasks roll up to. Beyond a title and description, each outcome has:

• Priority — Highest, High, Medium (the default), or Low, shown with a matching icon that rises with urgency. The list sorts highest-priority first.
• Tags — free-form labels (e.g. billing, q3) for organising and filtering.

Add an outcome (with priority + tags)

1. Open a project → Outcomes → New outcome.
2. Enter a title and (optionally) a description.
3. Pick a Priority from the dropdown.
4. In Tags, type a label and press Enter (or comma) to add it; add as many as you like; click the ✕ on a chip to remove one.
5. Click Create outcome.

Filter, edit, and see linked tasks

The Outcomes list has a search box plus status, priority, and tag filters. Click any outcome to open its detail: the goal, its status/priority/tags (click Edit to change them or retag), and every task linked to it — including the planning task — each linking to its own detail page.

Tasks: search, filter & details

The Tasks view is built for projects that accumulate a lot of work. By default it shows the 10 most recent tasks with a “Show all” expander.

• Search matches the title, role, and description.
• Quick status chips — All / Pending / In progress / Completed / Failed — each with a live count.
• Filter by agent — narrow to tasks a specific agent worked.

Task details

Click a task to open its detail page, which shows everything about it:

• status, role, type, and attempt count;
• who created it and when;
• the agent that worked it (linked to the agent's page);
• the outcome it rolls up to and any attached pull request;
• the description + acceptance criteria, notes/diagnosis, and the full result;
• a timeline of lifecycle events (created → claimed → done/failed).

Queries

Sometimes you just have a question about the system. Open a project → Queries → New query, type your question, and post it. An agent picks it up, reads the repository (read-only — it never changes code), and writes an answer you'll find on the query's detail page. The Queries list shows who asked and when, with search and pending/answered/asker filters. Full walkthrough: Ask a query.

Agents: logs & updates

Agents (top menu) lists every agent in your workspace with its connection, version, and model. Click one for its detail page.

• Logs — a scrollable view of the agent's recent output, plus Download all, and a retention control (how many days the server keeps). See Agent logs & retention.
• Update now — when a newer build is out, ask the agent to update itself after finishing its current task. See Update your agent.
• Auto-update — a checkbox that keeps the agent current automatically.
• Schedule & roles — per-project capabilities (Plan / Implement / Test / Review) are set on the project's Agents tab; weekly availability windows are set from the agent's row.

Users & roles

Manage who's in your organization from Users (top menu). You can invite people by email, change their role, transfer ownership, and remove members.

Invite someone

1. Open Users → Invite.
2. Enter their email and choose a role (you can't grant a role above your own).
3. Send it. If email is configured they get a link; otherwise copy the one-time invite link and share it. Accepting requires signing in with the invited email.

Org vs project roles

Org-wide roles (Owner, Admin, Member, Systems Admin, Org Read-Only) apply everywhere; project roles (Project Manager, Project Read-Only) grant access to a single project on top of that. Set project roles on a project's Members tab. Exactly what each role can do is in Roles & permissions.

Secrets

Secrets (top menu) is a write-only vault: values are encrypted and never shown again after you save them. Add a secret, optionally tag it (e.g. github) so it's easy to find later, then attach it to a project so that project's agents can fetch it while they work. A push credential for a repo is just a tagged secret you link on the project's Settings tab — see Git credentials.

Do it all from MCP

Everything above is available to an AI (or a script) over the public MCP server at mcp.keikaku.ai/mcp, using a Personal Access Token from the API tab in the app. There are tools for projects, outcomes (create_outcome, update_outcome, get_outcome), tasks (list_tasks, get_task), queries (create_query, list_queries), agents (get_agent_logs, request_agent_update, set_agent_auto_update, set_agent_log_retention), secrets, and more — so anything you can do in the portal, an agent can do for you.