resolve_project
Resolve the current Hub project from a workspace path or slug at session start, optionally creating a local registry entry. Prevents losing project context before running session_digest.
Instructions
Resolve the current Hub project from a workspace path or slug.
Use at session start before session_digest. With create_if_missing=true,
this may create a local project registry entry; false prevents creation.
An existing project_slug with workspace_path still registers that path.
Use upsert_project for explicit metadata or forge configuration changes.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "resolve_project"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | Display title for a newly created project; defaults to slug or workspace basename. Does not rename an existing project. | |
| project_slug | No | Project identifier, checked before workspace_path; missing slugs are normalized on creation. | |
| workspace_path | No | Client workspace folder path, matched to registered paths or basename; may be registered when project_slug resolves. | |
| create_if_missing | No | Defaults to true: create a missing registry entry. False prevents creation, but an existing slug may gain workspace_path. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | No | ||
| tags | No | ||
| error | No | Present only when no project was resolved. | |
| title | No | ||
| repo_url | No | ||
| created_at | No | ||
| forge_repo | No | ||
| sort_order | No | ||
| updated_at | No | ||
| archived_at | No | ||
| description | No | ||
| forge_owner | No | ||
| parent_slug | No | ||
| default_energy | No | ||
| forge_wiki_path | No | ||
| workspace_paths | No | ||
| forge_project_id | No | ||
| default_work_source | No | ||
| forge_connection_profile_id | No |