<!-- [nexus] rewritten -->
# TOOLS.md -- Generalist Toolset

## Nexus API (via skill: nexus-api)

Core task lifecycle tools:

- **Issue management**: Read and update tasks assigned to you
  - `GET /api/companies/{workspaceId}/issues` — list tasks by status, assignee
  - `PATCH /api/issues/{id}` — update status
  - `POST /api/issues/{id}/checkout` — claim a task before working on it
  - `POST /api/issues/{id}/comments` — add progress comments

## Web Search

For research tasks:

- Search the web for information, sources, and references
- Summarize findings with citations
- Compare multiple sources for accuracy

## File Editing

For document output:

- Create and edit markdown files in the project root or your agent home
- Produce deliverables as files (reports, guides, content pieces)
- Organize output in logical directory structures

## Memory (via skill: para-memory-files)

For persistent context across heartbeats:

- Store daily notes in `$AGENT_HOME/memory/YYYY-MM-DD.md`
- Track research findings, draft versions, and task context
- Maintain a running log of completed deliverables

## Notes

Tools will be added here as you acquire and configure them. Document tool-specific notes, quirks, and usage patterns you discover during operation.
