Tag grammar

Use tags to group related items. A tag starts with #, @, or +. The prefix sets the tag namespace.

Hash tags

In a Note or Log entry, #x means #area/x. In a Task, #x means #task/x.

Text	Item	Saved tag
#work	Note or Log entry	#area/work
#work	Task	#task/work
#area/work	Any item that supports tags	#area/work
#task/work	Any item that supports tags	#task/work

The #area/… and #task/… forms stay as written. Use them when you need to name a specific area or task tag.

Context and project tags

Use @name for a context. calternal reads @home as context/home.

Use +name for a project. calternal reads +calternal as project/calternal.

Literal tags

Use two number signs to escape a hash tag. ##x means the literal tag x. calternal does not add the area/ or task/ namespace to this tag.

Search for a tag

Tags are space-joined. Hash tags keep the # sign. Search for tag:work to find items with a namespaced tag such as #area/work or #task/work.

calternal does not rewrite existing tags during migration. Existing files keep their written tag form.